<think>嗯，用户的问题很明确：他想在
Linux系统上
部署悟空IM。这属于一个具体的技术实施问题，需要提供清晰的步骤指导。用户应该是开发者或
运维人员，对
Linux环境有基本了解，但可能不熟悉这个特定项目的
部署细节。
从引用内容看，
悟空IM是用Go语言开发的高性能通讯服务，项目启动文件在cmd/wukongim/main.go。引用[2]提到它使用自定义二进制协议、分布式Raft等技术，说明
部署时可能需要关注网络和存储配置。引用[4]的MySQL连接串格式也提示数据库配置是重点。
用户没有说明具体
Linux发行版，所以需要给出通用方案。考虑到开源项目常见依赖，我决定以Ubuntu为例，但注明其他发行版可调整包管理命令。核心步骤应该包括：
1）基础环境准备：Go语言环境、Git、MySQL等
2）获取代码：从GitHub克隆仓库
3）配置：重点处理数据库连接和端口设置
4）编译运行：Go项目的标准编译流程
5）验证：简单的curl测试
需要特别注意引用[1]提到的配置加载逻辑——main.go会调用config.LoadConfig()，所以必须确保配置文件路径正确。另外引用[2]强调“分布式多层领导机制”，如果用户未来要
部署集群，这里需要埋个伏笔，在相关问题里提示集群
部署的特殊性。
安全方面要提醒防火墙设置，特别是
悟空IM使用的tcp/5000端口和ws/5001端口。用户可能忽略这点导致服务无法访问。
最后生成的问题要覆盖延伸需求：性能优化是开发者常关注的，而Windows
部署则是典型场景扩展。特意加入“与OpenIM对比”是考虑到引用[3]提到同类产品，用户可能有技术选型需求。</think>好的，在
Linux 系统上
部署悟空IM (WuKongIM) 可以按照以下步骤进行。
部署过程主要涉及环境准备、代码获取、配置修改、编译构建和启动运行。
**
部署步骤：**
1. **系统环境准备 (以 Ubuntu/Debian 为例，其他发行版类似调整包管理命令)：**
* **更新系统：**
```bash
sudo apt update && sudo apt upgrade -y
```
* **安装基础依赖：**
```bash
sudo apt install -y git wget curl build-essential
```
* **安装 Go 语言环境 (版本 >= 1.18，推荐 1.20+):**
* 访问 [Go 官方下载页](https://go.dev/dl/) 获取最新稳定版的
Linux 二进制包链接。
* 下载并安装 (替换 `<version>` 和 `<arch>` 为实际值，如 `go1.22.3.
linux-amd64.tar.gz`)：
```bash
wget https://go.dev/dl/go<version>.
linux-<arch>.tar.gz
sudo tar -C /usr/local -xzf go<version>.
linux-<arch>.tar.gz
```
* 设置环境变量 (将以下内容添加到 `~/.bashrc` 或 `~/.zshrc` 或 `~/.profile` 文件中)：
```bash
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
```
* 使环境变量生效：
```bash
source ~/.bashrc # 或 source ~/.zshrc / source ~/.profile
```
* 验证安装：
```bash
go version
```
* **安装 MySQL (版本 5.7+ 或 8.0+):**
* 参考官方文档或使用发行版包管理器安装。例如 Ubuntu:
```bash
sudo apt install -y mysql-server
sudo systemctl start mysql
sudo systemctl enable mysql
sudo mysql_secure_installation # 运行安全配置脚本，设置 root 密码等
```
* **创建
悟空IM数据库和用户：**
```bash
mysql -u root -p
```
```sql
CREATE DATABASE wukongim DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wukongim'@'localhost' IDENTIFIED BY 'your_strong_password'; -- 替换为强密码
GRANT ALL PRIVILEGES ON wukongim.* TO 'wukongim'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```
* **(可选) 安装 Redis (用于缓存或会话管理)：**
* 如果项目配置需要 Redis，则安装：
```bash
sudo apt install -y redis-server
sudo systemctl start redis-server
sudo systemctl enable redis-server
```
2. **获取
悟空IM源代码：**
```bash
git clone https://github.com/WuKongIM/WuKongIM.git
cd WuKongIM
```
* 建议切换到稳定版本分支或标签 (查看项目 Releases 页)：
```bash
git checkout tags/v1.0.0 # 替换 v1.0.0 为实际的稳定版本号
```
3. **配置
悟空IM：**
*
悟空IM 的配置文件通常位于 `config` 目录下（例如 `config.yaml` 或 `config.toml`），具体名称和格式请参考项目文档或代码中的示例配置文件（如 `config.example.yaml`）。
* **核心配置项：**
* **数据库连接：** 配置步骤 1 中创建的 MySQL 数据库信息 (地址、端口、用户名、密码、数据库名)。
```yaml
# 示例 (YAML 格式)
storage:
default:
driver: "mysql"
dsn: "wukongim:your_strong_password@tcp(127.0.0.1:3306)/wukongim?charset=utf8mb4&parseTime=True&loc=Local"
```
* **监听地址和端口：** 配置服务监听的 IP 和端口 (如 TCP 5000, WS 5001)。
```yaml
server:
addr: ":5000" # TCP 服务端口
ws_addr: ":5001" # WebSocket 服务端口
```
* **节点ID (NodeID)：** 如果
部署集群，需要为每个节点配置唯一 ID。
* **Redis 配置 (如果使用)：** 配置 Redis 连接信息。
* **日志级别和路径：** 配置日志输出级别 (debug, info, warn, error) 和文件路径。
* **其他配置：** 如 JWT 密钥、消息存储路径、集群配置等，根据项目文档和实际需求调整。
* **复制示例配置文件并修改：**
```bash
cp config/config.example.yaml config/config.yaml # 假设示例文件是 config.example.yaml
nano config/config.yaml # 使用你喜欢的编辑器 (vim, nano, vscode) 编辑配置文件
```
* 仔细修改上述提到的核心配置项，确保数据库连接字符串、端口、密码等准确无误。
4. **编译
悟空IM：**
* 项目入口点在 `cmd/wukongim/main.go` [^1]。
* 使用 Go 的 `build` 命令编译：
```bash
go build -o wukongim ./cmd/wukongim # -o wukongim 指定输出可执行文件名
```
* 编译成功后，当前目录会生成名为 `wukongim` (或你指定的名字) 的二进制文件。
5. **启动
悟空IM服务：**
* **直接启动 (前台运行，适合调试)：**
```bash
./wukongim -c config/config.yaml # 使用 -c 参数指定配置文件路径
```
* 观察控制台日志输出，检查是否有错误信息。如果看到服务成功监听端口的日志，则表示启动成功。
* **使用 Systemd 管理 (后台运行，生产环境推荐)：**
* 创建 Systemd 服务文件 `/etc/systemd/system/wukongim.service`：
```ini
[Unit]
Description=WuKongIM Service
After=network.target mysql.service redis.service # 依赖网络、MySQL，如果用了Redis也加上
[Service]
Type=simple
User=root # 或者创建一个专用用户，如 wukongim
Group=root
WorkingDirectory=/path/to/WuKongIM # 替换为你的
悟空IM项目克隆目录
ExecStart=/path/to/WuKongIM/wukongim -c /path/to/WuKongIM/config/config.yaml # 替换二进制和配置文件路径
Restart=always
RestartSec=5s
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=wukongim
[Install]
WantedBy=multi-user.target
```
* 启用并启动服务：
```bash
sudo systemctl daemon-reload
sudo systemctl enable wukongim
sudo systemctl start wukongim
```
* 检查服务状态和日志：
```bash
sudo systemctl status wukongim
journalctl -u wukongim -f # 查看实时日志
```
6. **验证服务：**
* 检查服务进程是否存在：`ps aux | grep wukongim`
* 检查服务监听的端口：
```bash
sudo netstat -tulnp | grep -E '5000|5001' # 替换为你配置的端口
```
* 查看日志文件或 Systemd 日志 (`journalctl -u wukongim`)，确认无 ERROR 级别的错误，并有成功启动的 INFO 日志。
* **(简单 API 测试 - 如果提供了 HTTP API):** 使用 `curl` 测试一个简单的接口 (如健康检查 `/health`，如果存在)：
```bash
curl http://localhost:5000/health # 替换为你的端口和路径
```
* **(客户端连接测试):** 使用
悟空IM提供的客户端 SDK 或示例客户端程序连接配置的 WebSocket (`ws://your_server_ip:5001`) 或 TCP 端口，尝试登录和发送消息。
**注意事项：**
1. **防火墙：** 确保
Linux 防火墙 (如 `ufw` 或 `firewalld`) 开放了
悟空IM服务监听的端口 (如 TCP 5000, 5001)。
2. **配置文件路径：** 启动命令中的配置文件路径 (`-c` 参数) 必须是绝对路径或相对于工作目录的正确路径。
3. **数据库权限：** 确保 MySQL 用户 `wukongim` 对数据库 `wukongim` 拥有足够的权限 (`GRANT ALL PRIVILEGES`)。
4. **版本兼容性：** 注意 Go 版本、MySQL 版本与
悟空IM代码版本的兼容性，尽量使用项目推荐的版本。
5. **生产环境优化：** 生产环境应考虑：
* 使用专用系统用户运行服务。
* 配置更详细的日志轮转。
* 配置监控和告警。
* 根据负载调整数据库和 Redis 配置。
*
部署负载均衡和集群 (参考
悟空IM集群
部署文档)。
6. **查阅官方文档：**
部署前务必查阅
悟空IM项目 `README.md` 或 `docs` 目录下的最新官方文档，获取最准确、最详细的安装、配置和
部署说明。项目可能更新了依赖或
部署流程。
**引用说明:**
* `项目的启动文件位于 cmd/wukongim/main.go` 和项目结构信息来源于引用 [^1]。
*
悟空IM的核心特性和技术栈 (自定义协议、分布式Raft、关系数据库、Reactor模式等) 参考了引用 [^2]。
* 数据库配置格式参考了引用 [^4] 中 MySQL JDBC URL 的样式。
扫一扫
1381
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
