https://github.com/samzong/ConfigForge
An open-source SSH and Kubernetes configuration management tool designed for macOS users.
https://github.com/samzong/ConfigForge
kubeconfig kubectl kubernetes ssh sshconfig
Last synced: 9 days ago
JSON representation
An open-source SSH and Kubernetes configuration management tool designed for macOS users.
- Host: GitHub
- URL: https://github.com/samzong/ConfigForge
- Owner: samzong
- License: mit
- Created: 2025-04-02T09:06:06.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-21T10:44:22.000Z (14 days ago)
- Last Synced: 2025-04-21T11:40:29.284Z (14 days ago)
- Topics: kubeconfig, kubectl, kubernetes, ssh, sshconfig
- Language: Swift
- Homepage:
- Size: 2.01 MB
- Stars: 13
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-swift-macos-apps - ConfigForge - Open-source SSH and Kubernetes Configuration Management Tool. (Utilities / Text)
README
# 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 安装（推荐）
```bash
brew tap samzong/tap
brew install configforge
```
通过 Homebrew 安装后，桌面应用将安装到 Applications 文件夹，CLI 工具 `cf` 会自动添加到您的 PATH 中。
### 手动安装
1. 从 [Releases](https://github.com/samzong/ConfigForge/releases) 页面下载最新的 DMG 文件
2. 打开 DMG 文件并将 ConfigForge 应用拖动到 Applications 文件夹
3. 首次运行时，系统可能会提示"无法验证开发者"，请在系统偏好设置中允许运行
要手动安装 CLI 工具，请运行以下命令：
```bash
sudo ln -sf /Applications/ConfigForge.app/Contents/Resources/bin/cf /usr/local/bin/cf
```
## 开发者指南
如果您对开发感兴趣，请查看 [DEVELOPMENT.md](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](LICENSE) 文件。
## 鸣谢
- 感谢所有开源项目贡献者
- [Swift](https://swift.org/) 和 [SwiftUI](https://developer.apple.com/xcode/swiftui/) 团队
- [Swift Argument Parser](https://github.com/apple/swift-argument-parser) 用于 CLI 开发
- 所有为项目提供反馈和建议的用户