Paperclip

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 với quyền 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 thao tác Paperclip phải chạy dưới user 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 onboarding)

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

paperclipai onboard

Bước này cấu hình instance của bạn cho lần sử dụng đầu tiên.

3. Khởi động Paperclip

Khởi động ứng dụng:

paperclipai run

Để tiến trình tiếp tục chạy sau khi đăng xuất, dùng các công cụ như tmux

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

Sau khi khởi động (trừ khi đã cấu hình lại), hệ thống mở ra:

• 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 binding, port hoặc domain trong quá trì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 UI an toàn (tunneling SSH)

Từ máy local của bạn, chạy:

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

Đăng nhập bằng thông tin xác thực được lưu trên server tại:

/root/.cloudzy-creds

Điều hướng đến http://127.0.0.1:3100 trên trình duyệt local để truy cập UI Paperclip.

Đảm bảo Paperclip đang chạy trên server, nếu không UI và API sẽ không truy cập đượ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ú

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