跳转到内容

批量导入服务器

使用 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 配置,单独检查敏感接口是否允许明文访问。

  1. 创建 JSON 数组,并在其中填入服务器配置对象。
  2. 打开 设置 → 备份 → 导入 → 服务器。
  3. 选择 JSON 文件。
  4. 核对页面显示的服务器数量并确认导入。
  5. 导入完成后删除 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 设置符合预期。