努力
加油

同一个项目在单台机器上如何部署多个不同环境的实例?

在单台物理机或虚拟机上部署多个不同环境(如 Dev、Test、Staging、Prod)的实例,是中小团队或者个人开发者节省成本的常见做法。但这也意味着你要在一个“沙盒”里玩火,隔离性不好容易互相干扰。

核心思路就两个:网络端口隔离 + 进程/用户隔离。

下面我按从简单到专业、从传统到云原生的顺序,给你梳理几种主流方案。你可以根据你的技术栈和项目复杂度来选。


方案一:最朴素直接法——多实例+不同端口(适合 Web/Nginx 类应用)

如果你的项目是纯静态资源、或者前后端分离的 Web 应用,这是成本最低的方式。

原理:
每个环境启动一个独立的进程或服务,监听不同的 TCP 端口。通过 Nginx 做反向XX,根据域名或 URL 路径分发流量。

操作步骤:

  1. 代码目录隔离:

    /opt/app/dev   # 开发环境代码
    /opt/app/test  # 测试环境代码
    /opt/app/prod  # 生产环境代码
  2. 配置独立进程:

    • Dev 环境启动在 8081 端口
    • Test 环境启动在 8082 端口
    • Prod 环境启动在 8083 端口
  3. Nginx 反向XX配置:

    server {
        listen 80;
        server_name dev.example.com;
        location / {
            proxy_pass http://127.0.0.1:8081;
        }
    }
    
    server {
        listen 80;
        server_name test.example.com;
        location / {
            proxy_pass http://127.0.0.1:8082;
        }
    }
    
    server {
        listen 80;
        server_name prod.example.com;
        location / {
            proxy_pass http://127.0.0.1:8083;
        }
    }
  4. 数据库隔离(关键点):

    • 如果用的是 MySQL,可以在同一台机器上跑多个 MySQL 实例(不同端口),或者使用不同的 Database Name。
    • 强烈建议:即使在同一台机器,也尽量用不同的 Database Schema 或者不同的 MySQL 实例端口,避免数据污染。

优点:配置简单,无需额外软件。
缺点:管理混乱,升级麻烦,资源争抢严重,一旦某个实例内存泄漏可能拖垮整个机器。


方案二:标准化运维法——Systemd 服务管理(推荐大多数场景)

如果你不想手动敲命令启动/停止,而是希望像服务一样管理,用 Linux 自带的 systemd 是最稳妥的。

原理:
为每个环境编写独立的 .service 文件,由 systemd 统一调度。

操作步骤:

  1. 创建服务文件:
    在 /etc/systemd/system/ 下创建三个文件:

    • app-dev.service
    • app-test.service
    • app-prod.service
  2. Service 内容示例 (app-dev.service):

    [Unit]
    Description=App Dev Environment
    After=network.target
    
    [Service]
    Type=simple
    User=www-data          # 指定运行用户,实现用户级隔离
    WorkingDirectory=/opt/app/dev
    ExecStart=/usr/bin/node app.js --port 8081
    Restart=always
    Environment=NODE_ENV=development
    
    [Install]
    WantedBy=multi-user.target
  3. 启用并启动:

    systemctl daemon-reload
    systemctl enable app-dev app-test app-prod
    systemctl start app-dev app-test app-prod

优点:

  • 开机自启。
  • 崩溃自动重启。
  • 日志可以通过 journalctl -u app-dev 查看。
  • 用户隔离,防止权限越界。

缺点:依然共享操作系统内核资源,无法做到真正的硬隔离。


方案三:轻量级容器化——Docker Compose(当前主流推荐)

现在几乎没人还用裸机部署多环境了,Docker 是性价比最高的选择。它提供了进程隔离、文件系统隔离和网络隔离。

原理:
每个环境一个 Docker 容器,通过 Docker Network 互联,通过 Volume 挂载数据。

操作步骤:

  1. 目录结构:

    /opt/docker-compose/
    ├── dev/
    │   ├── docker-compose.yml
    │   └── Dockerfile
    ├── test/
    │   ├── docker-compose.yml
    │   └── Dockerfile
    └── prod/
        ├── docker-compose.yml
        └── Dockerfile
  2. Dev 环境 docker-compose.yml 示例:

    version: '3'
    services:
      web:
        build: .
        ports:
          - "8081:80"
        environment:
          - ENV=dev
        volumes:
          - ./data:/app/data
      db:
        image: mysql:5.7
        ports:
          - "33061:3306"
        environment:
          MYSQL_DATABASE: dev_db
  3. 启动:

    cd dev && docker-compose up -d
    cd ../test && docker-compose up -d
    cd ../prod && docker-compose up -d

优点:

  • 环境一致性:代码和依赖打包在一起,杜绝“在我机器上是好的”这种问题。
  • 资源限制:可以在 compose 中限制 CPU 和内存(deploy.resources.limits),防止某个环境把机器撑爆。
  • 易于迁移:以后换服务器,直接把文件夹拷过去就行。

注意:

  • 不同环境的数据库端口不要冲突(如上面所示,dev 用 33061,test 用 33062)。
  • 如果使用 Redis、MQ 等中间件,同样需要独立容器和端口映射。

方案四:硬核隔离法——LXC/LXD 或 KVM(适合高要求场景)

如果你对稳定性要求极高,比如生产环境绝对不能被测试环境搞挂,那么容器还不够,需要接近虚拟机的隔离级别。

LXC/LXD:
比 Docker 更底层,提供的是系统级容器。每个环境像一个精简版的 Linux 系统,拥有独立的 PID 空间、网络栈。

KVM/VirtManager:
直接在宿主机上开几个小虚拟机。这是真正的硬件虚拟化隔离,性能损耗稍大,但安全性最高。

适用场景:

  • 公司合规要求严格,必须物理/逻辑强隔离。
  • 运行不同操作系统的服务(比如一个环境要跑 Windows 程序,另一个跑 Linux)。

关键避坑指南(血泪经验)

无论选哪种方案,以下三点必须注意,否则后期维护会疯掉:

1. 端口规划表(Port Mapping Table)

一定要有一个 Excel 表格记录清楚:
| 环境 | 应用端口 | DB 端口 | Redis 端口 | Nginx 入口 |
| :— | :— | :— | :— | :— |
| Dev | 8081 | 33061 | 63791 | 80 (dev.xxx.com) |
| Test | 8082 | 33062 | 63792 | 80 (test.xxx.com) |
| Prod | 8083 | 33063 | 63793 | 80 (xxx.com) |

切忌:所有环境都用 3306 和 6379,你会因为端口占用报错而怀疑人生。

2. 磁盘与 I/O 隔离

  • 日志分开写:不要让所有环境的日志都往 /var/log/syslog 或者同一个文件里狂刷。配置 Logrotate,按环境分目录存储。
  • 临时文件清理:确保每个环境有独立的 temp 目录,并且定期清理,防止磁盘被占满导致 OOM(Out of Memory)。

3. 备份策略

  • 数据库备份:这是最重要的。既然在一台机器上,最怕的是误删库或者磁盘损坏。
    • 给每个环境的数据库设置独立的备份脚本。
    • 备份文件不要只存在本机!务必通过 rsync 或脚本推送到另一台机器或 OSS/S3 对象存储。
    • 定期测试恢复流程,不然备份就是心理安慰。

4. 安全加固

  • 防火墙:只开放必要的端口(如 80, 443, SSH)。内部服务之间的通信(如 App 连 DB)尽量通过 localhost 或 Docker 内部网络,不要暴露到公网 IP。
  • SSH 访问:禁止 root 直接登录,使用密钥认证。不同环境建议使用不同的非 root 用户运行服务。

总结建议

  • 个人项目/小团队:直接用 Docker Compose,配合 Nginx 反向XX。这是目前性价比最高、扩展性最好、最容易管理的方案。
  • 极简需求:如果只有两个环境,且不用复杂中间件,可以用 Systemd + 不同端口,省去 Docker 的开销。
  • 正式生产环境:强烈建议不要把 Prod 和其他环境混放在同一台物理机上。如果预算有限,至少要把 Prod 放在独立的云服务器上,或者使用 Kubernetes/Docker Swarm 做集群管理,哪怕只是两台低配机器组成的集群,也比单机单点风险低得多。

最后提醒一句:单机多环境的核心痛点不是“怎么跑起来”,而是“怎么不出错”和“怎么快速排查”。做好日志规范和端口规划,比折腾技术选型更重要。