服务器管理

服务器标签页是 ServerCC 的主入口。在这里你可以添加、编辑和管理所有远程服务器。

添加服务器

点击服务器标签页右上角的 + 按钮添加新服务器。

服务器信息

• 服务器名称 — 一个易于识别的名称（如"开发服务器"、"生产环境"）
• 主机 — 服务器的 IP 地址或主机名
• 端口 — SSH 端口，默认为 22
• 用户名 — 你的 SSH 登录用户名

认证方式

ServerCC 支持两种认证方式：

• 密码 — 直接输入 SSH 密码。安全存储在 iOS 钥匙串中。
• 私钥 — 选择已导入的 SSH 密钥。支持 Ed25519 和 RSA 密钥，包括有密码保护的密钥。详见 SSH 密钥。

环境变量

你可以配置连接服务器时设置的环境变量。常用变量包括：

• ANTHROPIC_BASE_URL — 自定义 API 基础 URL（用于代理或备用端点）
• ANTHROPIC_AUTH_TOKEN — Anthropic API 的认证令牌

你还可以添加工作流程所需的任何自定义键值对环境变量。

Tailscale

如果你的服务器在 Tailscale 网络中，你无须安装全局 Tailscale VPN 即可连接。打开通过 Tailscale 连接开关并粘贴你的 Tailscale Auth Key。在主机字段中使用 Tailscale IP（如 100.x.y.z）或 MagicDNS 主机名。

详见 内置 Tailscale 完整指南。

工作区根目录

工作区根目录是 ServerCC 在服务器上创建和管理工作区的位置。默认为 ~/.servercc。此设置在服务器创建后不可更改。

服务器详情

点击列表中的服务器查看详情页面。在这里你可以：

连接状态

服务器详情页面显示实时连接状态指示器。绿色对勾表示服务器可达。如果有错误，点击状态可查看完整的错误信息。

Claude Code 安装

Claude Code 部分显示 Claude Code 和 Codex 是否已安装在服务器上及其版本。你可以：

• 安装 Claude Code — 一键安装，实时显示进度
• 升级 Claude Code — 更新到最新版本
• Claude Code 设置 — 配置此服务器上的 Claude Code 行为

如果 Claude Code 或 Codex 安装在 ServerCC 无法自动识别的位置（非标准前缀、版本管理器、特殊 shell 配置），点击手动设置自定义路径并用文件浏览器选择二进制文件。状态随后会显示已安装（自定义路径）。自定义路径不支持 App 内升级 — 自行更新 CLI 后 ServerCC 会识别新版本。

工具

工具部分汇集了服务器级别的实用功能：

• 纯终端 — 不带 Claude Code/Codex 的直接 SSH Shell — 适合运行系统命令、检查日志或进行常规服务器管理
• VNC — 连接服务器的远程桌面 — 见 VNC 远程桌面
• 端口 — 在内置浏览器中通过 HTTP 打开任意监听端口 — 见端口访问

编辑和删除服务器

在服务器列表中：

• 向左滑动 显示编辑按钮 — 修改服务器名称、主机、端口、凭据或环境变量
• 向右滑动 显示删除按钮 — 永久删除服务器及其所有工作区

连接管理

ServerCC 自动管理 SSH 连接：

• 连接池 — 连接在各功能之间共享和复用
• 心跳检测 — 30 秒心跳保持连接活跃
• 自动重连 — 断开的连接会自动重新建立
• 空闲清理 — 空闲 60 秒后未使用的连接会自动关闭