CodexHub：把 Codex App 的 SSH 多服务器群工作流装进一个桌面控制台

标签：Codex App、SSH、Tauri、React、Rust、AI 开发工具、远程开发 项目地址：https://github.com/Jurio0304/CodexHub Release 下载：https://github.com/Jurio0304/CodexHub/releases

如果你已经开始用 Codex App 做日常开发，大概率会遇到一个很现实的问题：本地电脑只是入口，真正的项目、依赖、GPU 环境、长期运行服务，往往分散在多台 Linux 服务器上。

这时候，SSH 连接、远端 Codex CLI、~/.codex/config.toml、skills 同步、profile 切换、日志排查，就会慢慢变成一堆散落在终端、文档和脑子里的操作步骤。

CodexHub 想解决的正是这件事：它是一个面向 Codex App SSH 多服务器群工作流的桌面控制台，帮你把多台远端主机的准备、检查、配置和同步流程变得快速、可视化、可预览、可追踪。

为什么需要 CodexHub

当你只连接一台服务器时，手动维护 SSH 配置还可以接受。但当远端环境变多之后，很多事情会变得重复而容易出错：

• 本地有没有可用的 OpenSSH 和 Ed25519 公钥？
• 某台服务器的 SSH alias 是否能正常连通？
• 远端是否已经安装 Codex CLI？版本是否需要更新？
• ~/.local/bin 是否在 PATH 里？
• 远端 ~/.codex/config.toml 当前是什么状态？
• 本地 profile 应用到远端前，变更内容能不能先预览？
• skills 装到了本机还是远端？哪些主机已经同步？
• 上一次失败到底是网络、权限、PATH，还是远端依赖问题？

CodexHub 把这些分散步骤收进一个桌面应用里，让你在真正打开 Codex App 进入开发前，先把远端工作空间准备好。

一屏看清所有主机状态

CodexHub 的 Dashboard 用来查看所有托管主机的整体状态，包括 SSH 连通性、远端 Codex 状态、profile 对齐情况、skill inventory 和近期任务结果。

你可以把它理解成一个面向 Codex SSH 工作流的“控制面板”：先看哪里没准备好，再点进对应页面处理。

添加主机：从一次性密码到密钥登录

在 Hosts 页面，你可以添加或检查 SSH 主机。CodexHub 支持读取本地 SSH config 中安全的 Host alias，也支持创建 CodexHub 托管的 Host block。

对于新服务器，它可以使用一次性密码完成初始化：安装本地 public key、修复远端 ~/.ssh 权限、写入受控 SSH 配置，然后验证 key 登录。这个密码只用于当前引导流程，不会被保存。

更重要的是，CodexHub 不会整体覆盖你的 SSH config。它只管理带有 CodexHub 标记的配置块，并在写入前创建时间戳备份。

一键安装和更新远端 Codex CLI

CodexHub 的远端维护路线很克制：它通过 SSH/SFTP 管理 Linux 主机，不在远端安装强绑定 wrapper，也不改 Codex App 私有状态。

安装或更新 Codex 时，CodexHub 会在远端用户目录下准备环境，保持最终命令仍然是正常的 codex。如果 ~/.local/bin 不在 PATH 中，它会以可重复执行的方式修复 shell 配置，并记录完整任务日志。

这意味着你后续在 Codex App 或普通 SSH 会话里使用的仍然是标准 Codex CLI，而不是某个不可见的中间层。

快捷的远端API相关配置

很多人使用远端 Codex 时，真正担心的不是“能不能写配置”，而是“写之前我能不能确认它会改什么”。

CodexHub 的 Profiles 页面支持管理本地 profile 模板，渲染为 TOML 后再应用到远端 ~/.codex/config.toml。应用前可以 preview，真正写入时会备份原文件；如果内容完全一致，则报告 no changes，不制造多余备份。

API key 处理也采用更安全的方式：远端配置使用环境变量引用，而不是把明文 key 写进远端 config、metadata 或任务日志。

此外，CodexHub支持检测本地cc-switch配置并一键导入；配合cc-switch可以实现单一API配置一键应用到所有主机，省去分别配置主机API的繁琐步骤。

Skills：本地导入、GitHub 下载、远端同步

CodexHub 也把 skills 管理纳入了同一个工作流。你可以导入包含 SKILL.md 的本地目录，也可以通过GitHub 仓库或仓库子目录 URL 下载对应skills。

导入后，CodexHub 会在自己的 app config 目录保存一份托管副本。安装到本机或远端目标时，会基于 inventory 判断哪些目标可安装、哪些已经存在。卸载时也不是硬删除，而是移动到备份目录，方便回滚。

任务：每次操作都有脱敏日志

远程环境出问题时，最怕的是“按钮点了，但不知道它到底做了什么”。CodexHub 的 Tasks 页面会记录命令状态、耗时、stdout/stderr、失败原因和关键证据，并默认脱敏 key material、token、passphrase 等敏感信息。

对于 SSH、安装、更新、profile apply、skill install 这类操作，任务日志能让你快速判断问题发生在哪一步。

设置：本地 SSH、更新检查和桌面UI偏好

设置页面负责本地 SSH 就绪检查、公钥复制、应用更新检查，以及桌面UI设置等偏好。

Windows 版本支持托盘图标；macOS 版本面向 Apple Silicon 提供 .dmg 安装包，但当前 macOS 构建仍是 unsigned/ad-hoc，首次打开可能需要通过系统安全设置手动允许。跨平台支持在推进中，日常使用请优先从 GitHub Releases 下载可信构建。

面向人群

CodexHub 特别适合这些场景：

• 你在 Windows 或 macOS 上使用 Codex App。
• 你经常连接多台 Linux 远程开发机。
• 你希望远端 Codex CLI、profile、skills 有统一的检查和同步入口。
• 你不想靠零散命令手动维护 SSH config 和远端 ~/.codex。
• 你在意变更前预览、写入前备份，以及失败后可追踪日志。

它像一个轻量但可靠的个人桌面控制台，专注于方便快捷的 Codex App SSH 远程多服务器管理。

技术栈

CodexHub 使用 Tauri 2 + React + TypeScript + Vite + Rust 构建。

前端负责桌面交互和状态呈现，Rust 后端负责本地 OpenSSH 调用、SSH config 解析、远端探测、文件备份、SFTP/SSH 操作和脱敏任务日志。这样的组合让它既保持桌面应用的轻量体验，也能安全地接触本地和远端系统能力。

它遵循一个很明确的边界：CodexHub 管理 SSH 和远端 Codex 配置，但不写 Codex App 私有数据库、socket、缓存或未公开状态。完成准备后，它会引导你到 Codex App 的 Settings > Codex > Connections 手动添加或启用已验证的 SSH alias。

快速开始

下载与反馈

项目地址：https://github.com/Jurio0304/CodexHub Release 下载：https://github.com/Jurio0304/CodexHub/releases

如果你也在使用 Codex App 连接多台远程 Linux 主机，欢迎试试 CodexHub。它不追求把所有事情都自动化，而是先把最容易出错、最需要审计的远程准备流程做清楚：能看见、能预览、有备份、可回滚、日志可追踪。

也欢迎在 GitHub 上提交 issue、建议和使用反馈。如果这个工具刚好解决了你的远程 Codex 工作流痛点，可以点一个 Star 支持一下。