参数管家（ConfigHub）支持

参数管家（ConfigHub）是一款面向长期维护远程服务器配置的 iOS / iPadOS 工具。应用主要通过 SSH（Secure Shell）协议与您指定的 Linux / Unix 服务器通信：浏览远程目录、读取与保存配置文件（如 YAML、JSON、.env 等），并在本地提供树形编辑、原始文本模式与版本时间轴等功能。

应用如何工作（SSH）

本应用不运营用于托管您配置内容的自有云端服务器。典型流程如下：

您在服务器上启用 SSH 服务，并确保本机或公网能访问对应端口（默认 22）。
在参数管家中创建项目，填写主机地址、端口、用户名，以及 SSH 登录密码（保存在系统钥匙串）。
应用通过 SSH 建立加密连接，使用 SFTP 相关能力列出目录、下载文件到设备编辑，保存时再写回服务器。
可选：将项目结构、版本快照、参数备注等通过 Apple iCloud 在您的设备间同步（由 Apple 提供，详见隐私政策）。

认证方式（当前版本）：参数管家仅支持 SSH 密码认证，暂不支持导入或粘贴 SSH 私钥、证书。若服务器关闭了密码登录、仅允许公钥，应用将无法连接，需在服务器上为该用户启用密码登录（见下文第 5 节），或等待后续版本支持私钥。

安全提示：密码保存在 iOS 钥匙串中。保存到远程服务器会直接修改线上文件，操作前请确认路径与权限。请为 SSH 账户设置强密码，并限制 root 直接登录。

在 Ubuntu 服务器上启用 SSH

以下以常见 Ubuntu Server 22.04 / 24.04 为例。云厂商（阿里云、腾讯云、AWS 等）还须在安全组 / 防火墙中放行 SSH 端口，否则公网无法连接。

1. 安装 OpenSSH 服务端

通过控制台或已有登录方式在服务器上执行：

sudo apt update
sudo apt install -y openssh-server

2. 启动并设置开机自启

sudo systemctl enable ssh
sudo systemctl start ssh
sudo systemctl status ssh

看到 active (running) 即表示服务已运行。部分系统服务名为 ssh，亦有发行版显示为 sshd，以 systemctl status ssh 输出为准。

3. 防火墙放行（若启用了 UFW）

sudo ufw allow OpenSSH
# 或指定端口：sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status

4. 确认监听端口与 IP

ss -tlnp | grep ssh
hostname -I

默认监听 0.0.0.0:22。在参数管家中填写：

主机：公网 IP、域名，或同一局域网内的内网 IP
端口：22（若已修改 /etc/ssh/sshd_config 中的 Port，请填实际端口）
用户名：如 ubuntu（AWS）、root 或您创建的系统用户

5. 允许密码登录（应用必需）

参数管家连接时需填写用户名 + 密码。请确认服务器 sshd 未禁用密码认证。编辑配置（路径因发行版可能为 /etc/ssh/sshd_config）：

PasswordAuthentication yes
# 若存在且为 no，请改为 yes：
# KbdInteractiveAuthentication yes

修改后重载服务：

sudo systemctl reload ssh

为该 Linux 用户设置登录密码（若尚未设置）：

sudo passwd 您的用户名

在 Mac 终端可用密码测试（确认与 App 相同方式可连）：

ssh -p 22 用户名@服务器地址

说明：您仍可在服务器或终端使用 SSH 密钥登录；本应用当前版本不会读取私钥文件。若云厂商镜像默认「仅密钥、无密码」，请按控制台文档为实例设置密码，或临时开启密码认证后再在应用中保存连接。

6. 其他发行版简述

Debian：与 Ubuntu 相同，包名一般为 openssh-server。
CentOS / RHEL / Rocky：sudo dnf install -y openssh-server && sudo systemctl enable --now sshd，防火墙使用 firewalld 放行 ssh 服务。
macOS 远程登录：系统设置 → 通用 → 共享 → 打开「远程登录」，应用同样通过 SSH 连接。

在应用中添加连接

打开参数管家 → 创建或进入项目。
配置 SSH 连接：主机、端口、用户名、密码（保存后写入钥匙串）。
使用远程浏览选择服务器上的配置文件路径，或手动输入路径。
编辑后保存将经 SSH 写回服务器；可先使用演示模式熟悉界面（不连接真实服务器）。

联系我们

电子邮件：zhangxiaouse@163.com
应用内：设置 → 支持 → 发送反馈（请说明系统版本、SSH 报错摘要，勿在邮件中发送服务器密码）

常见问题

SSH 无法连接 — 依次检查：地址与端口是否正确；云安全组是否放行；服务器 sshd 是否运行；用户名与密码是否正确；服务器是否允许密码登录（见上文第 5 节）。当前版本不支持私钥，仅密钥登录的服务器无法使用本应用。跳板机未内置，请直接连接目标主机或使用 VPN/隧道。
连接超时 — 多为网络或防火墙问题；内网 IP 无法在蜂窝网外访问，需公网 IP 或 VPN。
权限被拒绝（Permission denied） — 多为密码错误或该用户未允许密码认证；在终端用 ssh 用户@主机 验证密码。若服务器仅允许公钥，需在 sshd_config 启用 PasswordAuthentication yes 并设置用户密码。
保存失败 — 确认对该文件具备写权限（ls -l），磁盘是否已满，路径是否为目录而非文件。
iCloud 同步 — 在设备上登录 iCloud，在应用设置中开启同步；部分功能需 ConfigHub Pro 会员。
订阅与买断 — 在 iOS「设置 → Apple ID → 订阅」中管理或取消；重新安装后可在会员页面使用「恢复购买」。
密码锁 / Face ID — 在「设置 → 安全」中开启；系统权限提示语言与设备系统语言一致。

法律文档

English: ConfigHub Support (English)