在CentOS上部署Golang项目要注意啥

在CentOS上部署Golang项目的注意事项

1. 系统环境准备

• CentOS版本兼容性：建议使用CentOS Stream或较新的稳定版本（如CentOS 8/Stream 9），避免使用已结束生命周期的版本（如CentOS 7），若必须使用旧版本，需通过第三方源（如CentOS Vault）更新系统组件。
• Go环境配置：优先通过官方渠道下载Go安装包（而非yum默认仓库），解压至/usr/local目录，配置环境变量（GOROOT指向Go安装路径，GOPATH设置工作目录，PATH包含$GOROOT/bin和$GOPATH/bin），并通过source ~/.bashrc或source /etc/profile使配置生效。

2. 依赖管理

• 使用Go Modules：Go 1.11及以上版本推荐使用Go Modules进行依赖管理，初始化项目时执行go mod init <module-name>，添加依赖后运行go mod tidy自动清理未使用的依赖并下载缺失的包，确保依赖版本一致。
• 系统依赖检查：若项目依赖C库（如CGO相关的数据库驱动），需提前安装对应系统依赖（如gcc、mysql-devel），但建议通过CGO_ENABLED=0禁用CGO，生成静态链接的可执行文件，避免系统库版本冲突。

3. 编译优化

• 交叉编译配置：在本地开发环境（如Windows/macOS）或CI/CD流水线中，使用GOOS=linux（目标系统）、GOARCH=amd64（64位架构）、CGO_ENABLED=0（禁用CGO）命令交叉编译，生成适用于CentOS的可执行文件（如go build -o myapp-linux-amd64 main.go），无需在服务器上安装Go环境。
• 文件精简：通过-ldflags="-s -w"参数去除符号表和调试信息，减小可执行文件体积（如go build -ldflags="-s -w" -o myapp-linux-amd64 main.go），提升部署效率和运行性能。

4. 部署与权限管理

• 文件上传与权限：使用scp、rsync等工具将编译后的可执行文件上传至服务器，放置在专用目录（如/opt/myapp），并通过chmod +x myapp-linux-amd64赋予执行权限，避免使用chmod 777（过度开放权限）。
• 配置文件处理：将配置文件（如.env、config.ini）与可执行文件分离，存放在/etc/myapp或项目目录下的config子目录中，修改配置后需重启服务（如systemctl restart myapp）使变更生效，敏感信息（如数据库密码）建议使用加密工具（如vault）管理。

5. 进程与服务管理

• 使用systemd管理进程：创建systemd服务文件（如/etc/systemd/system/myapp.service），配置User（运行用户，建议使用非root用户，如appuser）、WorkingDirectory（项目目录）、ExecStart（可执行文件路径）、Restart=always（崩溃自动重启）等参数，通过systemctl daemon-reload、systemctl start myapp、systemctl enable myapp实现服务的启动、后台运行和开机自启。
• 优雅重启：生产环境中避免使用kill -9强制终止进程，应发送SIGTERM信号（如kill -15 <PID>），让应用完成当前请求后再退出，减少数据丢失风险。

6. 日志与监控

• 日志管理：使用nohup ./myapp > /var/log/myapp.log 2>&1 &将标准输出和错误输出重定向到日志文件，或通过log包将日志写入指定文件（如logFile, _ := os.OpenFile("/var/log/myapp.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)），定期使用logrotate工具轮转日志（如按天分割、保留7天），避免日志文件过大占用磁盘空间。
• 监控与告警：使用top、htop监控CPU和内存使用情况，通过netstat -tulnp查看端口监听状态，或集成Prometheus+Grafana监控系统指标（如QPS、响应时间），设置告警阈值（如CPU使用率超过80%时发送邮件通知），及时发现并解决问题。

7. 安全加固

• 防火墙配置：使用firewall-cmd开放应用所需端口（如HTTP的80端口、HTTPS的443端口），关闭不必要的端口（如SSH的22端口建议修改为非默认端口并限制访问IP），执行firewall-cmd --permanent --add-service=http、firewall-cmd --permanent --add-service=https、firewall-cmd --reload使配置生效。
• 用户权限控制：避免以root用户运行应用，创建专用用户（如appuser）并赋予最小必要权限（如useradd -r -s /sbin/nologin appuser），通过chown -R appuser:appuser /opt/myapp设置项目目录的所有者为该用户。
• 敏感信息保护：不要将数据库密码、API密钥等敏感信息硬编码在代码中，使用环境变量或加密配置文件（如godotenv库读取.env文件），定期更换敏感信息，避免泄露。

8. 可选优化：Docker部署

• 容器化部署：编写Dockerfile（基于官方golang镜像或alpine轻量级镜像），复制项目文件、安装依赖、编译代码，暴露应用端口（如EXPOSE 8080），构建镜像（docker build -t myapp）后通过docker run -p 8080:8080 -d --name myapp myapp运行容器，便于跨平台部署和环境一致性。