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

标签Codex App、SSH、Tauri、React、Rust、AI 开发工具、远程开发项目地址https://github.com/Jurio0304/CodexHubRelease 下载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 CLICodexHub 的远端维护路线很克制它通过 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。快速开始前往 GitHub Releases 下载最新 stable 版本。打开 CodexHub在 Settings 检查本地 SSH 状态。如果没有合适的 key再生成不覆盖旧文件的 Ed25519 key。添加 SSH host填写 host、user、port 和 identity file。对新服务器使用一次性密码引导再切换到 key 登录。测试 SSH alias并探测远端 Codex 状态。安装或更新远端 Codex CLI。创建 profile先 preview再 apply 到远端。导入 skill并安装到本机或远端目标。打开 Tasks 查看脱敏任务日志。回到 Codex App在Settings Codex Connections中添加或启用该 SSH alias。下载与反馈项目地址https://github.com/Jurio0304/CodexHubRelease 下载https://github.com/Jurio0304/CodexHub/releases如果你也在使用 Codex App 连接多台远程 Linux 主机欢迎试试 CodexHub。它不追求把所有事情都自动化而是先把最容易出错、最需要审计的远程准备流程做清楚能看见、能预览、有备份、可回滚、日志可追踪。也欢迎在 GitHub 上提交 issue、建议和使用反馈。如果这个工具刚好解决了你的远程 Codex 工作流痛点可以点一个 Star 支持一下。