# Nunu 高级布局项目部署指南

本文档提供在宝塔Linux服务器上部署此Go项目的详细步骤。

## 方法一：使用Docker部署（推荐）

从项目结构和Dockerfile看，项目已经准备好了Docker化部署，这是最简单的方式：

### 1. 在宝塔面板安装Docker管理器
- 登录宝塔面板
- 在软件商店中搜索并安装"Docker管理器"插件

### 2. 上传项目到服务器
- 通过SFTP或Git将项目上传到服务器
- 例如：`git clone 您的仓库地址 /www/wwwroot/go_project`

### 3. 构建Docker镜像
- 通过SSH连接到服务器
- 进入项目目录：`cd /www/wwwroot/go_project`
- 执行构建命令：
  ```bash
  docker build -t go-app:v1 --build-arg APP_RELATIVE_PATH=./cmd/server/... -f deploy/build/Dockerfile .
  ```

### 4. 运行Docker容器
```bash
docker run -d --restart=always --name go-app -p 8000:8000 go-app:v1
```

### 5. Docker容器管理命令

```bash
# 停止容器
docker stop go-app

# 启动已停止的容器
docker start go-app

# 重启容器
docker restart go-app

# 查看容器日志
docker logs go-app

# 查看正在运行的容器
docker ps

# 查看所有容器（包括已停止的）
docker ps -a

# 删除容器（需要先停止）
docker rm go-app
```

### 6. 配置反向代理（可选）
- 在宝塔面板中添加站点
- 设置反向代理到 `http://127.0.0.1:8000`

## 方法二：直接部署Go应用

如果不想使用Docker，也可以直接在服务器上编译运行：

### 1. 安装Go环境
- 在宝塔面板中通过"软件管理"安装"Go语言"
- 或通过SSH手动安装：
  ```bash
  wget https://golang.org/dl/go1.19.linux-amd64.tar.gz
  tar -C /usr/local -xzf go1.19.linux-amd64.tar.gz
  echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.profile
  source ~/.profile
  ```

### 2. 上传并编译项目
```bash
mkdir -p /www/wwwroot/go_project
cd /www/wwwroot/go_project
# 上传您的代码到这个目录
export GOPROXY=https://goproxy.cn,direct
go mod tidy
go build -o bin/server ./cmd/server/...
cp -r config bin/
```

### 3. 创建服务
创建systemd服务文件以便管理应用：
```bash
cat > /etc/systemd/system/go-app.service << EOF
[Unit]
Description=Go Application Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/www/wwwroot/go_project/bin
ExecStart=/www/wwwroot/go_project/bin/server
Restart=on-failure

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable go-app
systemctl start go-app
```

### 4. 配置反向代理
- 在宝塔面板中添加站点
- 设置反向代理到 `http://127.0.0.1:8000`

## 重要提示

1. 确保服务器防火墙开放了8000端口，或者您配置的其他端口
2. 如果使用Docker部署，请确保配置文件路径正确
3. 生产环境中，建议配置SSL证书以启用HTTPS
4. 您可能需要调整配置文件中的数据库连接信息等配置

## Go版本问题解决

如果在构建Docker镜像时遇到如下错误：

```
invalid go version '1.23.0': must match format 1.23
unknown directive: toolchain
```

这是因为Dockerfile使用的Go版本与go.mod中声明的版本不匹配。有两种解决方案：

### 方案一：更新Dockerfile中的Go版本

修改`deploy/build/Dockerfile`文件，将：
```dockerfile
FROM ${REGISTRY}/golang:1.19-alpine AS builder
```
更改为：
```dockerfile
FROM ${REGISTRY}/golang:1.24-alpine AS builder
```

### 方案二：修改go.mod文件

如果无法更新Docker环境中的Go版本，可以修改go.mod文件：

1. 将`go 1.23.0`更改为`go 1.19`
2. 删除`toolchain go1.24.1`行

## 验证部署
部署完成后，您可以通过以下方式验证服务是否正常运行：

1. 访问 `http://您的服务器IP:8000` 检查API是否正常响应
2. 访问 `http://您的服务器IP:8000/swagger/index.html` 查看API文档

## 故障排除

如遇到问题，请检查：

1. 日志信息：`docker logs go-app` 或 `journalctl -u go-app`
2. 配置文件是否正确
3. 数据库连接是否正常
4. 防火墙规则是否允许访问相关端口