You need to enable JavaScript to run this app. 从Homestead迁移后如何用Laravel Sail与Docker配置多项目多站点?
优惠活动
大模型
产品
解决方案
定价
更多

从Homestead迁移后如何用Laravel Sail与Docker配置多项目多站点?

Laravel Sail 多项目站点配置方案(对标Homestead映射逻辑)

Sail默认单项目运行、默认占用主机80端口的设计,和Homestead单宿主机多站点的习惯有差异,以下是三种可落地的配置方案,完全覆盖你之前的域名映射需求,没有多余组件依赖。

方案1:单Sail容器统一承载所有项目(最贴近Homestead体验)

这个方案和Homestead的架构一致:用一个Docker容器跑所有项目,通过Nginx配置区分不同域名对应的项目入口,不需要多套容器并行运行。
操作步骤:

  • 选一个项目作为主服务项目(比如之前的project1),先执行sail up -d确保基础环境正常
  • 编辑主项目的docker-compose.yml,在web服务的volumes配置块里,把其他所有项目的代码目录挂载进容器,示例配置:
    volumes:
      - ./:/var/www/html # 主项目,对应原project1
      - /本机/路径/project2:/var/www/project2 # 其他项目,对应原project2
    
  • 把Sail默认的Nginx配置文件复制到主项目根目录(配置路径根据你用的PHP版本从vendor/laravel/sail/runtimes/对应PHP版本/下找,一般文件名是nginx.conf)
  • 修改复制出来的自定义Nginx配置,添加多个server块匹配不同域名,示例:
    # 对应原homestead.test的映射
    server {
        listen 80;
        server_name homestead.test;
        root /var/www/html/public; # 指向主项目public目录
        # 保持和Sail默认配置一致的PHP解析规则,不要修改
    }
    # 对应原another.test的映射
    server {
        listen 80;
        server_name another.test;
        root /var/www/project2/public; # 指向project2的public目录
        # 同样保持默认PHP解析规则
    }
    
  • 回到主项目的docker-compose.yml,把自定义的Nginx配置挂载替换掉容器内的默认配置(在web服务的volumes里加一行):
    - ./nginx.conf:/etc/nginx/http.d/default.conf # 路径和对应PHP版本的Sail默认Nginx配置路径保持一致
    
  • 修改本机hosts文件,把两个域名指向本地回环地址:
    127.0.0.1   homestead.test
    127.0.0.1   another.test
    
  • 重启主项目的Sail服务:sail down && sail up -d,直接访问对应域名即可,和原来Homestead的使用体验完全一致。

注意:所有项目共享这个Sail容器内的PHP、Node环境,数据库、Redis等服务如果要共用,直接在主项目的docker-compose.yml里配置独立端口映射给其他项目连接即可,不需要重复启动服务。涉及APP_URL修改的项目,记得执行sail artisan config:clear清除配置缓存,避免路由生成、资源加载出现域名错误。

方案2:独立Sail项目+反向代理统一入口(项目隔离性更好)

这个方案每个项目单独跑独立的Sail容器,互不干扰,通过统一的Nginx反向代理转发域名请求,适合需要严格项目隔离的场景。
操作步骤:

  • 给每个项目设置独立的主机映射端口,避免端口冲突:分别编辑每个项目的.env文件,配置独立的APP_PORT值,比如project1设APP_PORT=8080,project2设APP_PORT=8081
  • 分别在每个项目目录下执行sail up -d启动所有项目,确认通过localhost:对应端口能正常访问每个项目
  • 在本机任意位置建一个独立的代理目录(比如~/sail-proxy),目录下新建两个文件:
    • docker-compose.yml:启动一个独立的Nginx代理容器,统一监听主机80端口
      services:
        proxy:
          image: nginx:alpine
          ports:
            - "80:80"
          volumes:
            - ./conf.d:/etc/nginx/conf.d
      
    • conf.d/default.conf:配置域名转发规则
      server {
          listen 80;
          server_name homestead.test;
          location / {
              proxy_pass http://host.docker.internal:8080; # 转发到project1的Sail端口
              proxy_set_header Host $host;
          }
      }
      server {
          listen 80;
          server_name another.test;
          location / {
              proxy_pass http://host.docker.internal:8081; # 转发到project2的Sail端口
              proxy_set_header Host $host;
          }
      }
      
  • 修改本机hosts文件,把两个域名指向127.0.0.1
  • 在代理目录下执行docker-compose up -d启动代理,直接访问对应域名即可。

方案3:简化版多项目配置(不需要统一入口,项目数量少时用)

如果觉得配置代理或者统一容器太麻烦,项目数量少的场景可以直接用端口+域名的组合:

  • 每个项目在.env里设置独立的APP_PORT,同时把APP_URL改成对应域名加端口的形式,比如project1设APP_URL=http://homestead.test:8080,project2设APP_URL=http://another.test:8081
  • 修改本机hosts文件,把两个域名指向127.0.0.1
  • 每个项目单独启动Sail服务即可,访问时需要带对应端口号,好处是不需要额外维护代理或者统一容器,配置成本最低。

内容的提问来源于stack exchange,提问作者Hanifeoglu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 13:06:11