本文介绍在 linux 服务器（如 ubuntu）上为 go、node.js、php 等多语言 web 应用统一规划部署路径的最佳实践，推荐以 `/opt` 为核心应用根目录，兼顾安全性、可维护性与跨 web 服务器（nginx/apache）兼容性。
在生产环境中组织多语言 Web 应用时，目录结构不仅是“文件放哪”的技术选择，更是运维规范、安全隔离与长期可维护性的基础。虽然 /var/www 因 Apache 默认配置而广为人知，但它本质上是Web 内容服务目录（即 HTTP 可访问的静态资源根），而非应用程序部署目录——将源码、二进制、配置、日志混置于其中，易引发权限混乱、意外暴露敏感文件（如 .env、config.go）或升级冲突。
✅ 推荐方案：以 /opt 作为所有自研/第三方应用的统一部署根目录
根据 Linux Filesystem Hierarchy Standard（FHS），/opt 专用于“add-on application software packages”——即独立安装、自包含、不依赖系统包管理器的第三方应用。它天然契合 Go（单二进制）、Node.js（node_modules + dist）、PHP（Composer 构建后产物）等现代应用的部署模型：
/opt/
├── my-cms/ # Go 应用（生产级部署）
│ ├── bin/ # 主二进制文件（如 ./bin/cms-server）
│ ├── public/ # 静态资源（由 Nginx 直接服务）
│ │ ├── css/
│ │ ├── images/
│ │ └── js/
│ ├── media/ # 用户上传内容（需独立挂载或配写权限）
│ └── config.yaml # 运行时配置（非源码，与代码分离）
├── api-nodejs/
│ ├── bin/app.js # 构建后的入口（或使用 pm2 启动 dist/index.js）
│ ├── public/ # 静态资产（如前端构建产物）
│ └── logs/ # 日志目录（建议软链至 /var/log/api-nodejs）
└── legacy-php/
├── htdocs/ # PHP 入口文件（index.php）及模板
└── vendor/ # Composer 安装的依赖（仅保留运行时所需）? 关键设计原则：
- 二进制与源码分离：Go 编译后仅部署 ./bin/cms-server，绝不上传 .go 源文件或 go.mod；Node.js 部署 dist/ 而非 src/；PHP 部署 htdocs/ 而非完整 Git 仓库。
- 静态资源显式归类：每个应用内设 public/ 子目录，由 Nginx 的 location /static/ { alias /opt/my-cms/public/; } 精确映射，避免路径穿越风险。
-
可写数据外置：media/、uploads/、cache/ 等需写入的目录不应与代码共存于 /opt，推荐：
- 临时缓存 → /tmp/my-cms-cache（重启丢失，适合 session/store）
- 持久化上传 → /var/lib/my-cms/media（配合 chown www-data:www-data 与严格 ACL）
- 日志 → /var/log/my-cms/（便于 logrotate 管理）
⚙️ Nginx 配置示例（Go 应用 + 静态资源分离）：
upstream go_backend {
server 127.0.0.1:8080; # Go 程序监听地址
}
server {
listen 80;
server_name cms.example.com;
# 静态资源由 Nginx 直接服务（零延迟、高并发）
location /static/ {
alias /opt/my-cms/public/;
expires 1y;
add_header Cache-Control "public, immutable";
}
# 动态请求代理至 Go 后端
location / {
proxy_pass http://go_backend;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}⚠️ 避坑提醒：
- ❌ 不要将应用部署在 /home/username/ 下：用户主目录默认有读写权限，且 ~/.bashrc 等文件可能被意外暴露；
- ❌ 避免 /var/www/html 混合多语言项目：该路径属 Apache 生态，Nginx 无原生语义，且 html 子目录易导致路径歧义（如 http://site.com/html/css/）；
- ✅ 所有 /opt/* 目录应由专用系统用户（如 cms-user）拥有，Web 服务器（www-data）仅对 public/ 和 media/ 有只读或最小必要权限，禁止执行位（chmod -x /opt/my-cms/bin/*）。
总结而言，/opt 不仅符合 FHS 规范，更通过物理隔离实现“应用即产品”的部署哲学——每个子目录是一个自洽单元，可独立备份、迁移、升级，且天然支持多语言共存。当你未来新增 Rust 服务或 Python FastAPI 应用时，只需遵循相同结构，即可无缝融入现有运维体系。
