一个 Node 小游戏怎么同时跑在根路径和 /play/xxx/ 子路径
问题
游戏做好了,要挂到平台的一个子路径下(https://example.com/play/majiang/),而不是独立域名。麻烦在于:前端代码里到处都是 /assets/tiles/wan1.png 这种绝对路径,Socket.IO 默认连 /socket.io,一挂到子路径就全 404。
三种解法:改 nginx 用 sub_filter 重写(脆)、给每个请求做运行时前缀补丁(也多一层)、在构建期把前缀烤进产物(最干净)。选第三种。
一、Vite 的 base 只解决一半
export default defineConfig({
base: process.env.VITE_BASE || '/',
});
打包时 VITE_BASE=/play/majiang/,index.html 里的 src、href 会被自动加上前缀。但代码里硬编码的字符串它不管——new Image().src = '/assets/ui/table-bg.png' 依然是根路径,运行时照样 404。
所以要一个入口:
export const BASE = import.meta.env.BASE_URL;
export function asset(p: string): string {
return BASE.replace(/\/+$/, '') + p;
}
然后所有资源引用统一走 asset('/assets/...')。dev 时 BASE = '/',得到 /assets/...;子路径部署时得到 /play/majiang/assets/...。同一份代码两种部署,不改一行。
接口同理,fetch(api('/api/guest'))。
二、Socket.IO 的 path 要单独设
io() 默认路径是 /socket.io,这个不会跟着 vite 的 base 走:
io({ path: api('/socket.io'), transports: ['websocket', 'polling'] });
于是客户端连的是 /play/majiang/socket.io,服务端自己还是 /socket.io——怎么对上?靠 nginx 把前缀剥掉。
三、nginx:删前缀 + 让 WebSocket 过
location = /play/majiang { return 301 /play/majiang/; }
location ^~ /play/majiang/ {
proxy_pass http://127.0.0.1:3600/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 600s;
proxy_buffering off;
}
三个要点:
proxy_pass末尾的/是关键。有它,/play/majiang/api/guest到上游变成/api/guest;没它,前缀会原样带过去,后端路由全对不上。Upgrade/Connection必须透传,否则 WebSocket 升级失败,Socket.IO 会退化成 polling(能用但每个消息一次 HTTP,牌局里延迟很明显)。proxy_read_timeout要放大。对局中服务端可能几十秒没有下行数据,默认 60s 会把长连接掐掉,表现是「打着打着就不动了」。
裸路径 /play/majiang(不带斜杠)不会命中 ^~ /play/majiang/,必须单独 301,否则点平台卡片会落到门户 404。
四、服务端只要两件事
- 静态目录用环境变量注入,别写死相对路径:
CLIENT_DIST=/opt/majiang/client/dist - 进程只监听
127.0.0.1,对外统一由 nginx 收口
pm2 一条就够:
{
name: 'majiang',
cwd: '/opt/majiang/server',
script: 'dist/index.js',
env: { NODE_ENV: 'production', PORT: '3600', HOST: '127.0.0.1', DATA_DIR: '/opt/majiang/data' }
}
五、怎么确认真的通了
不要只看首页 200。四件事都要过:
curl -o /dev/null -w '%{http_code}' https://example.com/play/majiang/ # 200
curl -o /dev/null -w '%{http_code}' https://example.com/play/majiang/assets/tiles/wan1.png # 200
curl -X POST https://example.com/play/majiang/api/guest -d '{}' # 200 + JSON
第四件是 WebSocket:看 nginx 日志里 /play/majiang/socket.io 有没有 101。只有 101 才说明升级成功;如果日志里只有 transport=polling 的 200,说明 Upgrade 头没透传。
最后在真实浏览器里开一局:手牌、弃牌、别人出牌、结算都要正常。静态资源 404 和 socket 掉线这两类问题,在 curl 层面是看不出来的。
一点补充
这套做法对「同一份产物部署到多个环境」也成立:VITE_BASE=/ 打包就是独立域名版,VITE_BASE=/play/majiang/ 就是子路径版,除了 nginx 配置不同,代码完全一致。