本文首发于 note.sichenai.cc原文链接https://note.sichenai.cc/articles/lightweight-server-deploy-pitfalls 作者斯晨先说结论。把一个 Node 应用搬到国内小内存服务器上有三条保命经验**服务器只收成品。**npm install、npm ci 这类依赖解析的活在开发机干完让服务器直接收整包。**node_modules 可以整机搬但原生包要按清单补。**纯 JavaScript 的包随便搬带平台二进制的包要分「构建期用」和「运行期用」两批另补。**SSH 会话里启动的后台任务默认活不过你的断开连接。**要它长命用 systemd-run。这三条是我用一个晚上换来的。下面按实际发生的顺序讲每件事都拆成现象、真因、处置三段报错原文一律保留不为「完美教程」修剪。实测环境腾讯云轻量应用服务器 2核4G2026-09 购入188 元/年档Ubuntu 26.04npm 9.2Docker 29.8.1大陆家用网络。实测日期 2026-09-20服务器初始化与 2026-09-24应用上机。开工前先撞两堵墙机器到手第一件事是装 Docker 跑两个自用的中间层容器结果两堵墙挨个撞上。**墙一Docker Hub 拉不动。**国内服务器直连 Docker Hub镜像拉取长时间无响应最后超时。解法是个梯度从省事到费事依次试装 Docker 本体走云厂商内网源拉镜像配厂商的镜像加速地址个别加速也拿不到的镜像在本机下载再传上去。**墙二镜像名是错的。**我照着教程写的名字拉镜像报 not found。到 Docker Hub 一搜才发现教程把名字写错了rsshub/rsshub 这个仓根本不存在真名是 diygod/rsshub。教程会过时转述会走样用镜像之前先去 registry 查一眼全名十秒钟的事能省半小时。顺手立了安全基线的规矩SSH 只留密钥登录、禁 root公网防火墙只开 22后来起的每个服务都只绑 127.0.0.1管理界面走 SSH 隧道看。这一段没有坑但值得抄。第一幕npm ci 跑了四十分钟我投降了代码上服务器按肌肉记忆敲了 npm ci起身倒水。回来一看CPU 顶着 100% 已经四十分钟没跑完。翻 debug 日志25 万行最后停在这一句silly placeDep ROOT next16.3.6 REPLACE for: opennextjs/aws翻译一下。npm 在解析依赖时需要在 next 15 和 next 16 之间反复横跳我的 package.json 声明 next ^15而另一个依赖的 peerDependencies 又放行了 next 16。npm 处理这种冲突的方式是把版本组合挨个试过去组合数是指数增长的术语叫版本回溯。开发机上这个爆炸可能几秒就过去了2 核弱机上每步慢十倍直接原地去世。坦白说我没回头试 --legacy-peer-deps 这类缓解参数当时的心思是让服务赶紧跑起来没心思给 npm 会诊。我直接换了条路线事后看也是更对的路线让服务器只收成品不做任何解析。具体三步代码用 git ls-files 列出受管文件清单rsync 按清单同步不碰 node_modules 也不带本地杂物node_modules 在开发机打成 tar 包ssh 一条命令灌过去791M从此服务器上不出现任何 npm install。第二幕依赖搬过去了缺了几块骨头整包搬运的隐患马上显形。node_modules 里的包其实分两种。一种是纯 JavaScript 写的放到哪台机器都能干活。另一种捆着编译好的二进制文件这些二进制跟操作系统和 CPU 架构绑定你在 Mac 上装的包里面的二进制说 macOS 话搬到 Linux 服务器上就成了哑巴。这次连炸两回位置还不重样。**第一回炸在类型检查。**next build 走到一半报错error: Cannot find module tarojs/cli这个有意思。我的仓里除了 Next 主应用还有个小程序子工程Taro 框架根目录 tsconfig 的 include 写的是 **/*.ts把子工程也扫了进来。类型检查要去找子工程的依赖而 Taro 的包装在 Mac 上服务器上没有。为什么开发时从没炸过因为那台 Mac 恰好装过。这种「单机从不暴露」的配置耦合换台机器准炸。修法是把子工程加进根 tsconfig 的 exclude。**第二回炸在运行期。**build 过了定时任务首跑又挂generateBinPath (.../esbuild/lib/main.js)这回是 esbuild。跑脚本的工具链要靠它安装时 npm 会按当前平台下对应的二进制Mac 上装的是 darwin 版服务器要的是 linux 版。两回合修法统一原生包按绑定时机分两批补。构建期绑定build 时才用到tailwindcss/oxide-linux-x64-gnu、lightningcss-linux-x64-gnu运行期绑定服务跑起来每次都要用esbuild/linux-x64、better-sqlite3补法从 registry 的元数据里查到准确版本的 tarball 直链用 npmmirror 镜像记得加 -L 跟随 302 跳转下载解压到 node_modules 里对应位置版本跟你已有的一模一样。有个运气成分要交代better-sqlite3 我原样直传过去居然能用node-erequire(better-sqlite3)实测通过。不同版本的打包策略不一样别默认它能活搬完务必跑一句这个验证。第三幕后台任务两次无声死亡依赖齐了构建也过了起服务、挂定时任务然后开始见鬼SSH 里跑的长任务过一阵去看进程没了日志停在半截没有报错。第一反应是内存爆了被系统干掉。dmesg 翻了没有 OOM 记录journalctl 翻了没有任何击杀日志。它就是消失了连句遗言都没有。把进程死亡时间和我的操作时间对了一遍规律出来了**进程死的时间跟我断开 SSH 的时间吻合。**我的推断是这样会话断开时系统把会话里启动的进程连带清理了。这段机制我没有日志层面的直接证据算推断但下面这个解法是实打实验证过的。setsid、nohup 都试过躲不过。正解是 systemd-runsudosystemd-run--uidubuntu--unitmigrate-jobbash-clong-task.sh touch /tmp/migrate-job.done它把任务放进系统作用域跟你的 SSH 会话从此没关系。任务完没完成轮询那个 done 标记文件就行。**花絮一枚值回票价。**有天晚上想杀掉卡住的 npm ci我敲了 pkill -f “npm ci”结果自己的 SSH 会话当场断成 exit 255。pkill 的 -f 是对整条命令行做匹配而我这条 pkill 命令自己身上就写着「npm ci」几个字成功自杀。一晚上干了两次。正确姿势先 ps 查 PID再按 PID 杀。最后装好的样子应用本体由 systemd 常驻定时任务三件套数据抓取、备份、巡检挂进 crontab部署当天首轮抓取全部成功。合上 MacBook服务照常跑这台 2 核 4G 的小机器从此就是它的家。复盘一张表坑症状真因处置服务器跑 npm ciCPU 满载 40 分钟不收敛debug log 25 万行peer 依赖版本回溯指数爆炸弱机放大依赖解析回开发机node_modules 打包直传类型检查炸Cannot find module ‘tarojs/cli’根 tsconfig include 扫进子工程其依赖只在 Mac 上有exclude 加子工程运行期炸generateBinPath 报错esbuild平台二进制Mac 装的是 darwin 版按构建期/运行期清单补 linux 包后台任务蒸发进程消失、日志半截、无 OOM 记录推断为 SSH 会话断开连带清理推断已标注systemd-run 脱离会话pkill 自杀SSH 会话 exit 255-f 匹配到自身命令行先查 PID 再杀Docker Hub 拉不动拉取超时国内直连不通内网源、镜像加速、本机中转三级梯度镜像名讹传pull 报 not found教程转述的名字是错的用前去 registry 查全名我跑通的路径和你能照抄的路径三件事说清楚免得你照着踩坑**我的环境有特殊性。**镜像加速地址是腾讯云机器专用的别家云有各自的地址「构建期/运行期」的原生包清单要按你自己的项目列我的清单oxide、lightningcss、esbuild、better-sqlite3只是长这样的一个样例。**两处没走到底如实交代。**npm 回溯我没试 --legacy-peer-deps 之类的缓解参数是直接换的路没验证过「撑下去」是否可行better-sqlite3 直传能用有运气成分你的版本未必。**一处没记录。**791M 打包直传的耗时我没记家用宽带上行各不相同你那边多快我给不了参考数。数据来源与视角本篇为本人部署实录2026-09-20 服务器初始化、2026-09-24 应用上机报错原文未润色「SSH 会话清理」机制一节为推断已就地标注文中价格与版本号为 2026-09 时点2核4G 足够跑这类单体小应用这个结论本身也来自本次实测