批量导入服务器
使用 JSON 文件可以一次添加多台服务器。数组中的每个对象代表一台服务器,并可包含连接方式、 分组标签和启动行为等设置。
JSON 格式
Section titled “JSON 格式”[ { "name": "My Server", "ssh": { "ip": "example.com", "port": 22, "user": "root", "pubKeyId": "" }, "tags": ["production"], "autoConnect": false }]SSH 配置位于 ssh 对象内。App 导出文件与导入对话框中的示例均采用这种嵌套格式。导入功能也兼容将 ip、port、user 等字段直接放在顶层的旧版格式(包括从 ~/.ssh/config 转换生成的配置)。
| 字段 | 必填 | 说明 |
|---|---|---|
name |
是 | 在 App 中显示的服务器名称 |
ssh |
否 | SSH 配置,见下表;纯 Monitor 服务器可以省略 |
monitorHttp |
否 | Monitor 配置:addr、user、pwd、certSha256、allowInsecure |
preferredTransport |
否 | 同时配置 SSH 和 Monitor HTTP 时优先使用哪一个:ssh 或 monitorHttp。省略时优先 SSH |
tags |
否 | 用于分组服务器的标签 |
autoConnect |
否 | App 启动时自动连接 |
custom |
否 | 当前服务器的附加配置,例如 preferTempDev、logoUrl |
pve |
否 | Proxmox VE 配置,见下文 |
wolCfg |
否 | Wake-on-LAN 配置 |
envs |
否 | 环境变量,仅对 SSH 终端生效 |
customSystemType |
否 | 跳过系统类型自动检测 |
disabledCmdTypes |
否 | 在该服务器上跳过的状态命令 |
id |
否 | 稳定的服务器 ID;省略或为空时由 App 在导入时生成 |
以下字段放在 ssh 对象中:
| 字段 | 必填 | 说明 |
|---|---|---|
ip |
是 | 域名或 IP 地址 |
port |
是 | SSH 端口,通常为 22 |
user |
是 | SSH 用户名 |
pwd |
否 | 密码(不推荐,建议使用 SSH 密钥) |
fileTransport |
否 | 文件传输协议:sftp 或 scp。默认为 sftp;不支持 SFTP 子系统的主机可使用 scp |
pubKeyId |
否 | 应用内已保存私钥的记录 ID(非 PEM 文件路径) |
keyPath |
否 | 私钥文件路径(仅桌面端使用,由 ~/.ssh/config 导入生成,连接时直接读取该文件) |
identityAgent |
否 | 提供密钥的 ssh-agent,写法同 IdentityAgent:SSH_AUTH_SOCK 或 socket 路径;Windows 上为 named pipe,写 SSH_AUTH_SOCK 而该变量未设置时为 \\.\pipe\openssh-ssh-agent。省略则不使用 agent。Linux、Windows 与 macOS |
forwardAgent |
否 | 将 identityAgent 转发给服务器的会话,同 ForwardAgent yes;连接期间服务器上的 root 可用其中的密钥签名。默认为 false |
alterUrl |
否 | 备用地址,格式为 user@ip:port |
jumpIds |
否 | 跳板机链,按服务器 ID 依次指定 |
controlPath |
否 | 该服务器 OpenSSH 主连接的 socket 路径,写法同 ControlPath。以它为跳板机的服务器在主连接运行时经由它连接。Linux 与 macOS |
proxyCommand |
否 | ProxyCommand(移动端在内置 Linux 环境中运行,与 jumpIds 互斥) |
以下字段位于 pve 对象内:
| 字段 | 必填 | 说明 |
|---|---|---|
addr |
是 | PVE Web 地址,例如 https://127.0.0.1:8006(主机名在服务器端解析) |
auth |
否 | token 或 password,默认为 password |
tokenId |
token 时必填 |
API 令牌 ID,格式为 user@realm!tokenid |
tokenSecret |
token 时必填 |
令牌密钥(属敏感凭据,请妥善保管导出文件) |
pwd |
否 | password 模式下使用:SSH 用户在 pam 域下的 PVE 密码。省略时默认使用 SSH 密码 |
certSha256 |
否 | 受信任证书的 SHA-256 指纹(小写十六进制)。省略时首次连接会提示确认证书 |
旧版导出文件将 pveAddr、pveIgnoreCert 和 pvePwd 放在 custom 对象中,导入时会忽略。如需保留 PVE,请改写为 pve 对象。
每台服务器至少需配置一种连接方式。若同时省略 ssh 和 monitorHttp,导入后将无法连接该主机。
allowInsecure 默认为 false。仅在确需通过明文 HTTP 连接 Monitor 时才设为 true(包括连接非回环的内网 IP 地址)。此外,Monitor 还会根据自身的 allow_insecure 配置,单独检查敏感接口是否允许明文访问。
- 创建 JSON 数组,并在其中填入服务器配置对象。
- 打开 设置 → 备份 → 导入 → 服务器。
- 选择 JSON 文件。
- 核对页面显示的服务器数量并确认导入。
- 导入完成后删除 JSON 文件及其副本。
[ { "name": "Production", "ssh": { "ip": "prod.example.com", "port": 22, "user": "admin", "pubKeyId": "my-key" }, "tags": ["production", "web"] }, { "name": "Development", "ssh": { "ip": "dev.example.com", "port": 2222, "user": "dev", "pubKeyId": "dev-key" }, "tags": ["development"] }, { "name": "Behind NAT", "monitorHttp": { "addr": "https://10.0.0.5:3770", "user": "admin" }, "tags": ["monitor"] }]导入后请逐一测试服务器连接,并确认服务器记录中的标签和 transport 设置符合预期。