beego项目部署linux核心三步：本地用bee pack -be goos=linux正确打包→上传解压至目标目录→在项目根目录执行nohup ./app >> app.log 2>&1 &启动；必须确保conf/static/views同级存在、可执行权限已赋、工作路径正确、防火墙及安全组放行端口，否则因路径或配置加载失败导致静默崩溃。
Beego 项目打包发布到 Linux 服务器，核心就三步：本地正确打包 → 上传解压 → 后台启动。但最容易出问题的是路径、权限、配置加载顺序和静态资源位置，不是“能跑起来”就算部署成功。
bee pack 打包命令必须带 -be GOOS=linux
直接执行 bee pack 默认按当前开发机系统打包（比如 macOS 或 Windows），生成的可执行文件在 Linux 上根本无法运行。必须显式指定目标平台：
-
bee pack -be GOOS=linux—— 最简写法，适用于 x86_64 架构的 CentOS/Ubuntu 等主流发行版 -
bee pack -be GOOS=linux -be GOARCH=arm64—— 麒麟、统信 UOS 等 ARM 服务器必须加GOARCH=arm64 - 别用
go build替代bee pack：后者会自动把conf/、static/、views/打进 tar 包，而前者只输出二进制，漏掉这些目录会导致 404 或模板渲染失败 - 打包前确保
conf/app.conf中runmode = prod和httpport已设为生产值，否则启动后监听 8080 且日志级别太低
解压后目录结构不能乱，conf/static/views 必须同级存在
bee pack -be GOOS=linux 生成的是 xxx.tar.gz，解压后得到一个**同名目录**（如 beepkg/），里面必须包含：
-
beepkg（可执行文件） -
conf/（含app.conf） -
static/（CSS/JS/img） -
views/（TPL 模板）
常见错误：
linux-performance-analyzer
下载
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
- 直接
tar -xvf beepkg.tar.gz -C /opt/app→ 解压到/opt/app/beepkg/，但误以为可执行文件在/opt/app/下，结果cd /opt/app && ./beepkg报错 “can't find conf/app.conf” - 手动把
conf拷到别处，或改名 → Beego 启动时读不到配置，沿用默认值（比如httpaddr = "127.0.0.1"），外网访问失败 - 没给可执行文件加权限 →
chmod +x beepkg缺失，运行时报 “Permission denied”
后台运行必须在项目根目录执行，且不能脱离上下文
Beego 运行时依赖当前工作目录下的 conf/、static/、views/。所以启动命令必须在解压后的项目目录内执行：
- ✅ 正确：
cd /opt/app/beepkg && nohup ./beepkg >> app.log 2>&1 & - ❌ 错误：
nohup /opt/app/beepkg/beepkg >> /opt/app/beepkg/app.log &—— 工作目录是/，找不到conf/app.conf - 别依赖
screen临时方案：它容易被意外 detach，且不处理崩溃重启；生产环境优先用supervisord或systemd - 如果用
supervisord，directory配置项必须设为项目根目录（如/opt/app/beepkg），否则一样报路径错误
防火墙、SELinux、端口暴露经常被忽略
即使程序跑起来了，外部也访问不了，大概率卡在这三处：
- Linux 防火墙（
iptables或firewalld）没开对应端口：firewall-cmd --permanent --add-port=8080/tcp && firewall-cmd --reload - 阿里云/腾讯云安全组没放行该端口 —— 这比服务器本机设置还优先，必须检查控制台
- SELinux 开启状态下，
nohup启动可能被拦截（尤其麒麟系统）：setenforce 0临时关闭，或配 policy（audit2allow） -
beego.AppConfig.String("httpport")读取的是conf/app.conf，不是代码里硬编码的值 —— 改了代码不改配置，端口还是旧的
真正麻烦的从来不是“怎么打包”，而是打包后那些隐式依赖：目录结构、工作路径、配置加载时机、系统策略限制。只要任意一环断开，服务就静默失败——连日志都不一定写出来。
