Kẹp Giấy

Cách sử dụng

0. SSH vào máy chủ

Kết nối với máy chủ của bạn dưới dạng root:

ssh root@<SERVER_IP>

Đăng nhập bằng mật khẩu của bạn.

1. Chuyển sang người dùng ứng dụng

Tất cả các hoạt động của Kẹp giấy phải chạy dưới sự điều khiển của người dùng chuyên dụng:

su - paperclip

KHÔNG chạy Paperclip với quyền root.

2. Thiết lập lần đầu (trình hướng dẫn tích hợp)

Chạy thiết lập tương tác:

paperclipai onboard

Việc này sẽ cấu hình phiên bản của bạn cho lần sử dụng đầu tiên.

3. Bắt đầu kẹp giấy

Khởi chạy ứng dụng:

paperclipai run

Để duy trì hoạt động sau khi đăng xuất, hãy sử dụng các công cụ như tmux

4. Dịch vụ mặc định

Sau khi chạy (trừ khi được cấu hình lại), hệ thống sẽ hiển thị:

• Máy chủ API → http://127.0.0.1:3100/api
• Kiểm tra sức khỏe → http://127.0.0.1:3100/api/health
• Giao diện người dùng → http://127.0.0.1:3100

Đây là các cài đặt mặc định và sẽ được áp dụng trừ khi bạn thay đổi rõ ràng ràng buộc, cổng hoặc miền trong khi định cấu hình.

5. Các lệnh hữu ích

# Help / CLI reference
paperclipai --help

# Diagnose issues
paperclipai doctor

# Reconfigure setup
paperclipai configure

# Print environment variables for deployment
paperclipai env

6. Truy cập giao diện người dùng một cách an toàn (đường hầm SSH)

Từ máy cục bộ của bạn, hãy chạy:

ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>

Đăng nhập bằng thông tin đăng nhập được lưu trữ trên máy chủ tại:

/root/.cloudzy-creds

Điều hướng đến http://127.0.0.1:3100 trong trình duyệt cục bộ của bạn để truy cập Giao diện người dùng Kẹp giấy.

Đảm bảo Paperclip đang chạy trên máy chủ, nếu không thì UI và API sẽ không thể truy cập được.

Các đường dẫn quan trọng

• Thư mục chính: /home/paperclip
• Cấu hình: /home/paperclip/.paperclip/instances/default/config.json
• Nhật ký/dữ liệu: /home/paperclip/.paperclip/
• Thư mục NVM: /home/paperclip/.nvm/

Ghi chú

• Đừng chạy paperclipai các lệnh dưới quyền root (luôn chạy dưới quyền paperclip người dùng)
• các paperclip thông tin đăng nhập của người dùng được lưu trữ an toàn trong /root/.cloudzy-creds
• Bạn cũng có thể đăng nhập trực tiếp với tư cách là paperclip người dùng sử dụng SSH: ssh paperclip@<SERVER_IP>
• Khi đăng nhập bằng root, luôn chuyển sang người dùng ứng dụng trước khi chạy bất kỳ lệnh Paperclip nào: su - paperclip
• Chạy onboard chỉ trong lần thiết lập đầu tiên
• Sử dụng configure sau này để thay đổi