初始化提交

mengyamonitor-backend/BUILD.md

@@ -0,0 +1,88 @@
+# 编译说明 - 兼容旧版本系统
+
+## 问题说明
+
+如果在 Debian 11 或其他旧版本系统上运行时出现 GLIBC 版本错误：
+```
+./mengyamonitor-backend: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.34' not found
+```
+
+这是因为编译时使用了较新版本的 GLIBC，而目标系统的 GLIBC 版本较旧。
+
+## 解决方案
+
+### 方案 1：在目标系统上编译（推荐）
+
+在 Debian 11 服务器上直接编译：
+
+```bash
+cd mengyamonitor-backend
+
+# 禁用 CGO，静态链接
+export CGO_ENABLED=0
+go build -ldflags="-s -w" -o mengyamonitor-backend .
+
+# 或者使用提供的脚本
+chmod +x build.sh
+./build.sh
+```
+
+### 方案 2：使用静态链接编译
+
+在任何系统上编译，但使用静态链接：
+
+```bash
+cd mengyamonitor-backend
+
+# 禁用 CGO
+export CGO_ENABLED=0
+export GOOS=linux
+export GOARCH=amd64
+
+# 编译（静态链接，不依赖系统库）
+go build -ldflags="-s -w" -o mengyamonitor-backend .
+```
+
+### 方案 3：使用 Docker 编译
+
+使用 Docker 在 Debian 11 环境中编译：
+
+```bash
+# 使用 Debian 11 镜像编译
+docker run --rm -v $(pwd):/app -w /app golang:1.21-bullseye sh -c "
+    export CGO_ENABLED=0
+    go build -ldflags='-s -w' -o mengyamonitor-backend .
+"
+
+# 或者使用多阶段构建
+docker build -t mengyamonitor-backend -f Dockerfile.build .
+```
+
+## 验证编译结果
+
+编译完成后，检查二进制文件：
+
+```bash
+# 检查文件类型
+file mengyamonitor-backend
+
+# 检查依赖（如果是静态链接，应该显示 "not a dynamic executable"）
+ldd mengyamonitor-backend
+
+# 检查 GLIBC 依赖（应该没有或很少）
+objdump -T mengyamonitor-backend | grep GLIBC
+```
+
+## 编译参数说明
+
+- `CGO_ENABLED=0`: 禁用 CGO，使用纯 Go 实现，不依赖系统 C 库
+- `-ldflags="-s -w"`: 减小二进制文件大小
+  - `-s`: 省略符号表和调试信息
+  - `-w`: 省略 DWARF 符号表
+
+## 注意事项
+
+1. 禁用 CGO 后，某些需要 C 库的功能可能不可用，但本项目不依赖 CGO
+2. 静态链接的二进制文件会稍大一些，但兼容性更好
+3. 如果必须使用 CGO，需要在目标系统上编译，或使用相同 GLIBC 版本的系统编译
+