iDB

基于 Go 语言构建的轻量级自托管运维平台
为开发者和小型团队而设计：一站式服务器管理与数据库快速部署工具

---

✨ 特性

服务器管理

• 系统监控：实时查看 CPU、内存、磁盘、网络等资源占用
• 进程管理：查看和管理系统进程
• 文件管理：浏览器式文件管理，支持上传、下载、编辑、压缩等操作
• 服务管理：管理系统服务，支持启动、停止、重启等操作

网络与安全

• 防火墙管理：基于 nftables 的防火墙配置
• SSH 管理：SSH 配置、密钥管理、登录日志
• 证书管理：生成和管理 SSL/TLS 证书

容器管理

• Docker 管理：容器、镜像、网络、卷的完整管理
• Docker Compose：支持 Docker Compose 应用管理
• 一键部署：快速部署 MySQL、PostgreSQL、Redis 等常用服务

工具集

• 日志管理：日志查看、搜索、实时跟踪
• 计划任务：定时任务管理
• 命令终端：Web 终端，支持多主机切换
• 文件同步：基于 rsync 的文件同步功能

多主机管理

• 统一管理：支持管理多台服务器
• 跨主机操作：支持跨服务器的文件传输、命令执行

---

📦 安装

一键安装

sudo curl -fsSL https://static.sensdata.com/idb/release/install.sh | sudo bash

Docker 安装

docker run -d \
  --name idb \
  --privileged \
  -p 9918:9918 \
  -v /var/lib/idb:/var/lib/idb \
  -v /var/run/docker.sock:/var/run/docker.sock \
  sensdb/idb

手动安装

1. 克隆仓库

git clone https://github.com/sensdata/idb.git
cd idb

2. 编译前端

cd frontend
npm install
npm run build
cd ..

3. 编译后端

cd center
make build

4. 安装

make install

---

🚀 快速开始

1. 访问控制台

   • 安装完成后，访问 http://your-server-ip:9918
   • 默认用户名：admin，密码：admin123

2. 添加服务器

   • 登录后，点击左侧菜单栏的「主机管理」
   • 点击「添加主机」，填写服务器信息
   • 选择安装方式（一键安装或手动安装）

3. 管理服务器

   • 服务器添加成功后，即可在控制台中管理该服务器
   • 点击服务器卡片，进入服务器详情页面
   • 可查看系统信息、管理进程、文件、服务等

4. 部署应用

   • 点击左侧菜单栏的「应用市场」
   • 选择要部署的应用（如 MySQL）
   • 填写配置信息，点击「部署」

---

📁 项目结构

idb/
├── agent/           # Agent 客户端代码
│   ├── agent/       # Agent 核心实现
│   ├── config/      # 配置管理
│   ├── db/          # 本地数据库
│   └── main.go      # Agent 入口
├── center/          # Center 服务器代码
│   ├── config/      # 配置管理
│   ├── core/        # 核心功能实现
│   ├── db/          # 数据库模型和仓库
│   ├── plugin/      # 插件系统
│   └── main.go      # Center 入口
├── core/            # 公共库和定义
│   ├── constant/    # 常量定义
│   ├── model/       # 数据模型
│   └── utils/       # 工具函数
├── frontend/        # 前端代码
│   ├── src/         # 前端源码
│   └── package.json # 前端依赖
├── LICENSE          # 许可证文件
└── README.md        # 项目说明

---

🔧 开发环境

后端开发

1. 环境要求

   • Go 1.23+

2. 启动开发服务器

   cd center
   go run main.go start

前端开发

1. 环境要求

   • Node.js 18+
   • npm 或 yarn

2. 安装依赖

   cd frontend
   npm install

3. 启动开发服务器

   npm run dev

---

🤝 贡献

如何贡献

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

开发规范

• 代码风格：遵循 Go 官方代码风格
• 提交信息：清晰、简洁，使用英文
• 测试：为新功能添加测试
• 文档：更新相关文档

代码结构

• 新增功能请遵循现有代码结构
• 核心功能添加到 core/ 目录
• 服务器功能添加到 center/ 目录
• 客户端功能添加到 agent/ 目录

---

📄 许可证

本项目采用 Apache License 2.0 许可证。详情请查看 LICENSE 文件。

---

📚 文档

• API 文档
• 架构设计
• 插件开发指南
• 常见问题

---

📬 联系

• 问题反馈：GitHub Issues
• 讨论交流：GitHub Discussions

---

📊 数据

• Docker 下载量：1 万+
• 支持系统：Ubuntu、Debian、CentOS、Rocky Linux、Kylin、UnionTech 等
• 云平台支持：AWS、Azure、Google Cloud、阿里云、腾讯云、华为云、UCloud 等

---

🔗 相关链接

• Docker Hub
• GitHub

---

感谢使用 iDB！ 🎉