用法
0.通过SSH连接到服务器
以 root 身份连接到您的服务器:
ssh root@<SERVER_IP>
使用您的密码登录。
1.切换到应用程序用户
所有回形针操作都必须在专用用户下运行:
su - paperclip
不要以 root 身份运行 Paperclip。
2. 首次设置(入门向导)
运行交互式设置:
paperclipai onboard
这将配置您的实例以供首次使用。
3.启动回形针
启动应用程序:
paperclipai run
要在注销后保持其运行,请使用类似的工具 tmux
4.默认服务
一旦运行(除非重新配置),系统会公开:
- API 服务器 →
http://127.0.0.1:3100/api - 健康检查 →
http://127.0.0.1:3100/api/health - 用户界面 →
http://127.0.0.1:3100
这些是默认设置,除非您在配置期间显式更改绑定、端口或域,否则这些设置将适用。
5. 有用的命令
# Help / CLI reference
paperclipai --help
# Diagnose issues
paperclipai doctor
# Reconfigure setup
paperclipai configure
# Print environment variables for deployment
paperclipai env
6. 安全访问 UI(SSH 隧道)
从本地计算机运行:
ssh -L 3100:127.0.0.1:3100 paperclip@<SERVER_IP>
使用存储在服务器上的凭据登录:
/root/.cloudzy-creds
导航至 http://127.0.0.1:3100 在本地浏览器中访问 Paperclip UI。
确保 Paperclip 正在服务器上运行,否则 UI 和 API 将无法访问。
重要路径
- 主目录:
/home/paperclip - 配置:
/home/paperclip/.paperclip/instances/default/config.json - 日志/数据:
/home/paperclip/.paperclip/ - NVM目录:
/home/paperclip/.nvm/
笔记
- 不要跑
paperclipai以 root 身份执行命令(始终在paperclip用户) - 这
paperclip用户凭据安全地存储在/root/.cloudzy-creds - 您也可以直接登录
paperclip使用 SSH 的用户:ssh paperclip@<SERVER_IP> - 以 root 身份登录时,请始终在运行任何 Paperclip 命令之前切换到应用程序用户:
su - paperclip - 跑步
onboard仅在第一次设置时 - 使用
configure稍后进行更改