从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.dconf.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
相关产品推荐
相关产品推荐

