commits
This commit is contained in:
+299
-299
@@ -1,300 +1,300 @@
|
||||
## 方式一：使用 systemd 服务（推荐）
|
||||
|
||||
### 自动安装（推荐）
|
||||
|
||||
使用安装脚本自动配置 systemd 服务：
|
||||
|
||||
```bash
|
||||
# 进入脚本目录
|
||||
cd /www/wwwroot/api.yunzer.cn/scripts
|
||||
|
||||
# 添加执行权限
|
||||
chmod +x install-systemd-service.sh
|
||||
|
||||
# 运行安装脚本
|
||||
sudo bash install-systemd-service.sh
|
||||
|
||||
或者
|
||||
|
||||
sudo env PATH=$PATH:/usr/local/btgo/bin bash install-systemd-service.sh
|
||||
|
||||
|
||||
```
|
||||
|
||||
脚本会自动：
|
||||
- 停止现有服务和进程
|
||||
- 创建正确的 systemd 配置文件
|
||||
- 启动服务
|
||||
- 启用开机自启
|
||||
- 显示服务状态和日志
|
||||
|
||||
### 手动安装
|
||||
|
||||
如果需要手动配置：
|
||||
|
||||
```bash
|
||||
# 1. 停止现有服务
|
||||
systemctl stop go-api
|
||||
pkill -f "go run main.go"
|
||||
|
||||
# 2. 复制服务文件
|
||||
sudo cp /www/wwwroot/api.yunzer.cn/scripts/go-api.service /etc/systemd/system/
|
||||
|
||||
# 3. 重载 systemd
|
||||
sudo systemctl daemon-reload
|
||||
|
||||
# 4. 启动服务
|
||||
sudo systemctl start go-api
|
||||
|
||||
# 5. 启用开机自启
|
||||
sudo systemctl enable go-api
|
||||
|
||||
# 6. 查看状态
|
||||
sudo systemctl status go-api
|
||||
```
|
||||
|
||||
### 启动服务
|
||||
```bash
|
||||
systemctl start go-api
|
||||
```
|
||||
|
||||
### 查看状态
|
||||
```bash
|
||||
systemctl status go-api
|
||||
```
|
||||
|
||||
### 常用命令
|
||||
```bash
|
||||
# 启动
|
||||
systemctl start go-api
|
||||
|
||||
# 停止
|
||||
systemctl stop go-api
|
||||
|
||||
# 重启
|
||||
systemctl restart go-api
|
||||
|
||||
# 查看状态
|
||||
systemctl status go-api
|
||||
|
||||
# 查看日志（systemd 日志）
|
||||
journalctl -u go-api -f
|
||||
|
||||
# 查看日志（文件日志）
|
||||
tail -f /www/wwwroot/api.yunzer.cn/go.log
|
||||
|
||||
# 开机自启
|
||||
systemctl enable go-api
|
||||
|
||||
# 禁用开机自启
|
||||
systemctl disable go-api
|
||||
```
|
||||
|
||||
## 方式二：使用管理脚本（推荐）
|
||||
|
||||
### 脚本位置
|
||||
```bash
|
||||
/www/wwwroot/api.yunzer.cn/scripts/service.sh
|
||||
```
|
||||
|
||||
### 添加执行权限
|
||||
```bash
|
||||
chmod +x /www/wwwroot/api.yunzer.cn/scripts/service.sh
|
||||
```
|
||||
|
||||
### 常用命令
|
||||
```bash
|
||||
# 启动服务
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh start
|
||||
|
||||
# 停止服务
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh stop
|
||||
|
||||
# 重启服务
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh restart
|
||||
|
||||
# 查看状态
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh status
|
||||
|
||||
# 查看日志（最后 50 行）
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh logs
|
||||
|
||||
# 实时查看日志
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh logs -f
|
||||
|
||||
# 查看最后 100 行日志
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh logs 100
|
||||
```
|
||||
|
||||
### 创建快捷命令（可选）
|
||||
```bash
|
||||
# 添加到 ~/.bashrc
|
||||
echo 'alias go-service="bash /www/wwwroot/api.yunzer.cn/scripts/service.sh"' >> ~/.bashrc
|
||||
source ~/.bashrc
|
||||
|
||||
# 使用快捷命令
|
||||
go-service start
|
||||
go-service restart
|
||||
go-service status
|
||||
go-service logs -f
|
||||
```
|
||||
|
||||
## 方式三：后台直接启动
|
||||
|
||||
### 启动服务
|
||||
```bash
|
||||
cd /www/wwwroot/api.yunzer.cn
|
||||
nohup go run main.go > go.log 2>&1 &
|
||||
```
|
||||
|
||||
### 查看是否运行成功
|
||||
```bash
|
||||
tail -f go.log
|
||||
```
|
||||
|
||||
### 查看进程
|
||||
```bash
|
||||
ps aux | grep "go run main.go" | grep -v grep
|
||||
```
|
||||
|
||||
### 重启服务
|
||||
```bash
|
||||
pkill -f "go run main.go" && cd /www/wwwroot/api.yunzer.cn && nohup go run main.go > go.log 2>&1 &
|
||||
```
|
||||
|
||||
### 停止服务
|
||||
```bash
|
||||
pkill -f "go run main.go"
|
||||
```
|
||||
|
||||
## 日志查看
|
||||
|
||||
### 查看实时日志
|
||||
```bash
|
||||
# systemd 方式
|
||||
journalctl -u go-api -f
|
||||
|
||||
# 直接启动方式
|
||||
tail -f /www/wwwroot/api.yunzer.cn/go.log
|
||||
```
|
||||
|
||||
### 查看最近日志
|
||||
```bash
|
||||
# systemd 方式
|
||||
journalctl -u go-api -n 100
|
||||
|
||||
# 直接启动方式
|
||||
tail -n 100 /www/wwwroot/api.yunzer.cn/go.log
|
||||
```
|
||||
|
||||
### 查看错误日志
|
||||
```bash
|
||||
# systemd 方式
|
||||
journalctl -u go-api -p err
|
||||
|
||||
# 直接启动方式
|
||||
grep -i error /www/wwwroot/api.yunzer.cn/go.log
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 1. 服务启动失败
|
||||
|
||||
**检查日志**：
|
||||
```bash
|
||||
# systemd
|
||||
journalctl -u go-api -n 50
|
||||
|
||||
# 直接启动
|
||||
tail -n 50 /www/wwwroot/api.yunzer.cn/go.log
|
||||
```
|
||||
|
||||
**常见原因**：
|
||||
- 端口被占用（8081）
|
||||
- 数据库连接失败
|
||||
- 配置文件错误
|
||||
|
||||
### 2. 端口被占用
|
||||
|
||||
**查看端口占用**：
|
||||
```bash
|
||||
netstat -tlnp | grep 8081
|
||||
# 或
|
||||
lsof -i :8081
|
||||
```
|
||||
|
||||
**停止占用进程**：
|
||||
```bash
|
||||
# 找到 PID
|
||||
lsof -i :8081
|
||||
|
||||
# 停止进程
|
||||
kill -9 <PID>
|
||||
```
|
||||
|
||||
### 3. 进程残留
|
||||
|
||||
**查找残留进程**：
|
||||
```bash
|
||||
ps aux | grep "go run main.go" | grep -v grep
|
||||
```
|
||||
|
||||
**清理残留进程**：
|
||||
```bash
|
||||
pkill -9 -f "go run main.go"
|
||||
```
|
||||
|
||||
### 4. 日志文件不存在
|
||||
|
||||
**原因**：启动命令没有重定向输出
|
||||
|
||||
**解决**：使用正确的启动命令
|
||||
```bash
|
||||
nohup go run main.go > go.log 2>&1 &
|
||||
```
|
||||
|
||||
## 性能监控
|
||||
|
||||
### 查看资源占用
|
||||
```bash
|
||||
# CPU 和内存
|
||||
top -p $(pgrep -f "go run main.go")
|
||||
|
||||
# 详细信息
|
||||
ps aux | grep "go run main.go" | grep -v grep
|
||||
```
|
||||
|
||||
### 查看连接数
|
||||
```bash
|
||||
netstat -an | grep 8081 | wc -l
|
||||
```
|
||||
|
||||
### 查看文件描述符
|
||||
```bash
|
||||
lsof -p $(pgrep -f "go run main.go") | wc -l
|
||||
```
|
||||
|
||||
## 生产环境建议
|
||||
|
||||
1. **使用 systemd 服务**：更稳定，支持自动重启
|
||||
2. **配置日志轮转**：防止日志文件过大
|
||||
3. **监控服务状态**：使用监控工具（如 Prometheus）
|
||||
4. **定期备份**：备份数据库和配置文件
|
||||
5. **使用编译后的二进制**：比 `go run` 更高效
|
||||
|
||||
### 编译并运行（推荐生产环境）
|
||||
```bash
|
||||
# 编译
|
||||
cd /www/wwwroot/api.yunzer.cn
|
||||
go build -o server main.go
|
||||
|
||||
# 运行
|
||||
nohup ./server > go.log 2>&1 &
|
||||
|
||||
# 或使用 systemd（修改 ExecStart）
|
||||
# ExecStart=/www/wwwroot/api.yunzer.cn/server
|
||||
```
|
||||
|
||||
## 更新日期
|
||||
|
||||
## 方式一：使用 systemd 服务（推荐）
|
||||
|
||||
### 自动安装（推荐）
|
||||
|
||||
使用安装脚本自动配置 systemd 服务：
|
||||
|
||||
```bash
|
||||
# 进入脚本目录
|
||||
cd /www/wwwroot/api.yunzer.cn/scripts
|
||||
|
||||
# 添加执行权限
|
||||
chmod +x install-systemd-service.sh
|
||||
|
||||
# 运行安装脚本
|
||||
sudo bash install-systemd-service.sh
|
||||
|
||||
或者
|
||||
|
||||
sudo env PATH=$PATH:/usr/local/btgo/bin bash install-systemd-service.sh
|
||||
|
||||
|
||||
```
|
||||
|
||||
脚本会自动：
|
||||
- 停止现有服务和进程
|
||||
- 创建正确的 systemd 配置文件
|
||||
- 启动服务
|
||||
- 启用开机自启
|
||||
- 显示服务状态和日志
|
||||
|
||||
### 手动安装
|
||||
|
||||
如果需要手动配置：
|
||||
|
||||
```bash
|
||||
# 1. 停止现有服务
|
||||
systemctl stop go-api
|
||||
pkill -f "go run main.go"
|
||||
|
||||
# 2. 复制服务文件
|
||||
sudo cp /www/wwwroot/api.yunzer.cn/scripts/go-api.service /etc/systemd/system/
|
||||
|
||||
# 3. 重载 systemd
|
||||
sudo systemctl daemon-reload
|
||||
|
||||
# 4. 启动服务
|
||||
sudo systemctl start go-api
|
||||
|
||||
# 5. 启用开机自启
|
||||
sudo systemctl enable go-api
|
||||
|
||||
# 6. 查看状态
|
||||
sudo systemctl status go-api
|
||||
```
|
||||
|
||||
### 启动服务
|
||||
```bash
|
||||
systemctl start go-api
|
||||
```
|
||||
|
||||
### 查看状态
|
||||
```bash
|
||||
systemctl status go-api
|
||||
```
|
||||
|
||||
### 常用命令
|
||||
```bash
|
||||
# 启动
|
||||
systemctl start go-api
|
||||
|
||||
# 停止
|
||||
systemctl stop go-api
|
||||
|
||||
# 重启
|
||||
systemctl restart go-api
|
||||
|
||||
# 查看状态
|
||||
systemctl status go-api
|
||||
|
||||
# 查看日志（systemd 日志）
|
||||
journalctl -u go-api -f
|
||||
|
||||
# 查看日志（文件日志）
|
||||
tail -f /www/wwwroot/api.yunzer.cn/go.log
|
||||
|
||||
# 开机自启
|
||||
systemctl enable go-api
|
||||
|
||||
# 禁用开机自启
|
||||
systemctl disable go-api
|
||||
```
|
||||
|
||||
## 方式二：使用管理脚本（推荐）
|
||||
|
||||
### 脚本位置
|
||||
```bash
|
||||
/www/wwwroot/api.yunzer.cn/scripts/service.sh
|
||||
```
|
||||
|
||||
### 添加执行权限
|
||||
```bash
|
||||
chmod +x /www/wwwroot/api.yunzer.cn/scripts/service.sh
|
||||
```
|
||||
|
||||
### 常用命令
|
||||
```bash
|
||||
# 启动服务
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh start
|
||||
|
||||
# 停止服务
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh stop
|
||||
|
||||
# 重启服务
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh restart
|
||||
|
||||
# 查看状态
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh status
|
||||
|
||||
# 查看日志（最后 50 行）
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh logs
|
||||
|
||||
# 实时查看日志
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh logs -f
|
||||
|
||||
# 查看最后 100 行日志
|
||||
bash /www/wwwroot/api.yunzer.cn/scripts/service.sh logs 100
|
||||
```
|
||||
|
||||
### 创建快捷命令（可选）
|
||||
```bash
|
||||
# 添加到 ~/.bashrc
|
||||
echo 'alias go-service="bash /www/wwwroot/api.yunzer.cn/scripts/service.sh"' >> ~/.bashrc
|
||||
source ~/.bashrc
|
||||
|
||||
# 使用快捷命令
|
||||
go-service start
|
||||
go-service restart
|
||||
go-service status
|
||||
go-service logs -f
|
||||
```
|
||||
|
||||
## 方式三：后台直接启动
|
||||
|
||||
### 启动服务
|
||||
```bash
|
||||
cd /www/wwwroot/api.yunzer.cn
|
||||
nohup go run main.go > go.log 2>&1 &
|
||||
```
|
||||
|
||||
### 查看是否运行成功
|
||||
```bash
|
||||
tail -f go.log
|
||||
```
|
||||
|
||||
### 查看进程
|
||||
```bash
|
||||
ps aux | grep "go run main.go" | grep -v grep
|
||||
```
|
||||
|
||||
### 重启服务
|
||||
```bash
|
||||
pkill -f "go run main.go" && cd /www/wwwroot/api.yunzer.cn && nohup go run main.go > go.log 2>&1 &
|
||||
```
|
||||
|
||||
### 停止服务
|
||||
```bash
|
||||
pkill -f "go run main.go"
|
||||
```
|
||||
|
||||
## 日志查看
|
||||
|
||||
### 查看实时日志
|
||||
```bash
|
||||
# systemd 方式
|
||||
journalctl -u go-api -f
|
||||
|
||||
# 直接启动方式
|
||||
tail -f /www/wwwroot/api.yunzer.cn/go.log
|
||||
```
|
||||
|
||||
### 查看最近日志
|
||||
```bash
|
||||
# systemd 方式
|
||||
journalctl -u go-api -n 100
|
||||
|
||||
# 直接启动方式
|
||||
tail -n 100 /www/wwwroot/api.yunzer.cn/go.log
|
||||
```
|
||||
|
||||
### 查看错误日志
|
||||
```bash
|
||||
# systemd 方式
|
||||
journalctl -u go-api -p err
|
||||
|
||||
# 直接启动方式
|
||||
grep -i error /www/wwwroot/api.yunzer.cn/go.log
|
||||
```
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 1. 服务启动失败
|
||||
|
||||
**检查日志**：
|
||||
```bash
|
||||
# systemd
|
||||
journalctl -u go-api -n 50
|
||||
|
||||
# 直接启动
|
||||
tail -n 50 /www/wwwroot/api.yunzer.cn/go.log
|
||||
```
|
||||
|
||||
**常见原因**：
|
||||
- 端口被占用（8081）
|
||||
- 数据库连接失败
|
||||
- 配置文件错误
|
||||
|
||||
### 2. 端口被占用
|
||||
|
||||
**查看端口占用**：
|
||||
```bash
|
||||
netstat -tlnp | grep 8081
|
||||
# 或
|
||||
lsof -i :8081
|
||||
```
|
||||
|
||||
**停止占用进程**：
|
||||
```bash
|
||||
# 找到 PID
|
||||
lsof -i :8081
|
||||
|
||||
# 停止进程
|
||||
kill -9 <PID>
|
||||
```
|
||||
|
||||
### 3. 进程残留
|
||||
|
||||
**查找残留进程**：
|
||||
```bash
|
||||
ps aux | grep "go run main.go" | grep -v grep
|
||||
```
|
||||
|
||||
**清理残留进程**：
|
||||
```bash
|
||||
pkill -9 -f "go run main.go"
|
||||
```
|
||||
|
||||
### 4. 日志文件不存在
|
||||
|
||||
**原因**：启动命令没有重定向输出
|
||||
|
||||
**解决**：使用正确的启动命令
|
||||
```bash
|
||||
nohup go run main.go > go.log 2>&1 &
|
||||
```
|
||||
|
||||
## 性能监控
|
||||
|
||||
### 查看资源占用
|
||||
```bash
|
||||
# CPU 和内存
|
||||
top -p $(pgrep -f "go run main.go")
|
||||
|
||||
# 详细信息
|
||||
ps aux | grep "go run main.go" | grep -v grep
|
||||
```
|
||||
|
||||
### 查看连接数
|
||||
```bash
|
||||
netstat -an | grep 8081 | wc -l
|
||||
```
|
||||
|
||||
### 查看文件描述符
|
||||
```bash
|
||||
lsof -p $(pgrep -f "go run main.go") | wc -l
|
||||
```
|
||||
|
||||
## 生产环境建议
|
||||
|
||||
1. **使用 systemd 服务**：更稳定，支持自动重启
|
||||
2. **配置日志轮转**：防止日志文件过大
|
||||
3. **监控服务状态**：使用监控工具（如 Prometheus）
|
||||
4. **定期备份**：备份数据库和配置文件
|
||||
5. **使用编译后的二进制**：比 `go run` 更高效
|
||||
|
||||
### 编译并运行（推荐生产环境）
|
||||
```bash
|
||||
# 编译
|
||||
cd /www/wwwroot/api.yunzer.cn
|
||||
go build -o server main.go
|
||||
|
||||
# 运行
|
||||
nohup ./server > go.log 2>&1 &
|
||||
|
||||
# 或使用 systemd（修改 ExecStart）
|
||||
# ExecStart=/www/wwwroot/api.yunzer.cn/server
|
||||
```
|
||||
|
||||
## 更新日期
|
||||
|
||||
2026-04-09
|
||||
Reference in New Issue
Block a user