ConfigForge

简洁高效的 macOS 配置管理工具

简介

ConfigForge 是一款专为 macOS 用户设计的开源配置管理工具，支持 SSH 配置和 Kubernetes 配置的可视化管理。提供简洁直观的图形界面来管理 ~/.ssh/config 和 ~/.kube/config 文件，让您轻松查看、搜索、编辑和管理各类配置，避免直接编辑文本文件的繁琐和错误风险。

作为一个完全开源的项目，ConfigForge 尊重用户的隐私和自由，所有代码公开透明，确保您的配置安全可靠。

主要功能

SSH 配置管理

• 直观的图形界面：清晰展示所有 SSH 配置条目
• 快速搜索与排序：轻松定位特定的 SSH 连接配置
• 便捷编辑：通过表单界面编辑 SSH 配置，无需手动输入复杂语法
• 基础语法高亮：提高配置文件的可读性
• 一键打开终端：提供快捷的方式一键连接到目标 SSH 主机

Kubernetes 配置管理

• 配置文件浏览：轻松查看和管理所有保存的 kubeconfig 配置文件
• 一键切换：快速切换活动的 kubeconfig 配置，自动备份现有配置
• 内容编辑：内置编辑器，支持自由编辑 Kubeconfig 文件内容
• 文件验证：自动验证配置文件格式，确保配置可用

命令行工具 (CLI)

• SSH 操作：在终端中列出、连接 SSH 主机
• Kubernetes 管理：快速查看和切换 Kubernetes 上下文
• 与桌面应用无缝集成：CLI 与桌面应用程序共享配置
• 易于使用：简洁的命令结构，内置帮助信息

通用功能

• 备份与恢复：安全备份和恢复配置文件
• 通用二进制：同时支持 Intel 和 Apple Silicon 芯片的 Mac 设备
• 国际化支持：提供中文和英文界面

安装

使用 Homebrew 安装（推荐）

brew tap samzong/tap
brew install configforge

通过 Homebrew 安装后，桌面应用将安装到 Applications 文件夹，CLI 工具 cf 会自动添加到您的 PATH 中。

手动安装

1. 从 Releases 页面下载最新的 DMG 文件
2. 打开 DMG 文件并将 ConfigForge 应用拖动到 Applications 文件夹
3. 首次运行时，系统可能会提示"无法验证开发者"，请在系统偏好设置中允许运行

要手动安装 CLI 工具，请运行以下命令：

sudo ln -sf /Applications/ConfigForge.app/Contents/Resources/bin/cf /usr/local/bin/cf

开发者指南

如果您对开发感兴趣，请查看 DEVELOPMENT.md 文件，其中包含完整的技术架构、组件设计和开发指南。

贡献

欢迎贡献代码、报告问题或提出功能建议！请参照以下步骤：

1. Fork 这个仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 开启一个 Pull Request

许可证

本项目采用 MIT 许可证 - 详情请参见 LICENSE 文件。

鸣谢

• 感谢所有开源项目贡献者
• Swift 和 SwiftUI 团队
• Swift Argument Parser 用于 CLI 开发
• 所有为项目提供反馈和建议的用户