想快速验证、快速分享,又不想花钱——我把所有项目都跑在了自己电脑上

39 阅读11分钟

参赛赛道:全链路开发实战

选题方向: 从 0 到 1 全链路开发

先说背景

我最近在尝试做副业,同时在推进的项目越来越多。有一个前提条件决定了后面所有的选择:在尝试阶段,我不想先花一笔钱去买服务器。

所以我的做法是——服务全部跑在自己的电脑上。我用的是 M1 Pro Max + 64G 内存的机器,跑这些绰绰有余,一分钱服务器成本都不用出。

代价是:本机上的进程越来越多。刚才数了一下,面板上登记了 11 个,而且 11 个全都在跑:

94e8c0eb9f60212e37173ab6f19f69b1.png

说清楚一点:64G 内存其实很宽裕,内存从来不是我的瓶颈。 真正让我烦的是「看不见」——不知道现在到底有哪些东西在跑、哪个是上周忘了停的、谁占着端口。资源被无声地占着,而我只能靠 ps aux 一条条猜。

麻烦的是管不过来:

  • 端口:想启一个新服务,提示端口被占用。翻半天 lsof 才找到占用者,发现是上周忘了停的某个项目
  • 状态:有的跑在终端里、有的被 launchd 托管、有的在容器里,散落各处,没有一个地方能一眼看全
  • 内存:虽然不紧张,但我也想知道谁是大头。941MB 的那个是正常的 Java 进程,还是某个内存泄漏的服务?这个问题以前答不上来
  • 域名:我想给几个自己用的服务挂公网域名,又不想买服务器。每个都手动配 nginx 反代、申请证书、改 DNS,是纯粹的重复劳动

所以这个工具的目标很窄:登记一次,之后打开面板就能看到谁在跑、占哪个端口、吃多少内存;不用的直接点停止,资源立刻还回来。

为什么最后没走 Docker

我一开始也想用 Docker Compose 一把梭——「一个文件起一组服务」听起来正好对上我的需求。试过之后放弃了。原因其实只有一条,其他都是次要的。

最重要的一条:我要的是省事,而 Docker 反而更费事。

我在尝试阶段,想法来了就得马上能跑起来看一眼。用 Docker,每个项目都要先写 Dockerfile、构建镜像、配 compose;Java 项目的 mvn package 加上构建镜像,动辄几分钟,改一行代码还要 rebuild 才能看到效果。而在宿主上,我只要一行 mvn spring-boot:run 或者 npm run dev,改完重启几秒生效,IDE 里断点也能直接打。

多出来的这一整套东西,对「我自己机器上临时跑一个服务、用完就停」这个场景不产生任何收益——我不需要环境隔离,不需要服务编排,也不需要为谁复现一套环境。它只是把「启动一个进程」这件事变复杂了。

所以 dev-hub 的设计也是照这个原则来的:登记一条命令就能跑,不新增任何构建步骤。 你原来怎么启动项目,就怎么写进去,一行 cd <路径> && <命令> 就完事了。没有 Dockerfile、没有 compose、没有 build——这就是它存在的全部理由。

次要的一点,顺便说清楚:内存。 在 macOS 上跑 Docker Desktop 要先起一个 Linux 虚拟机,那个 VM 空转就是 1GB 量级的开销,还没算容器里的东西。但我的机器是 64G,这点开销完全扛得住,所以内存不是我放弃 Docker 的理由,我不打算拿这个当卖点。

所以定位就清楚了:Docker 回答「这套环境怎么交付给别人、怎么稳定运行」,我要的是「少一步操作,把服务跑起来」。 这两件事不冲突,生产该用 Docker 用 Docker,但开发机上临时跑几个项目,是另一套问题。

实际长什么样

面板最左边一列是状态,然后依次是名称、端口、绑定的域名、PID、内存、工作目录(见开头那张图)。

几个我自己每天在用的点:

「外部启动」的标签。 面板上 quant(8050)和 seckill(4173)标的是「外部启动」——这两个都不是面板启动的,是我在终端里手动跑的。面板照样能认出它们、知道它们占哪个端口、吃多少内存,也能一键停掉。这是我最常用的场景:忘了自己开过什么的时候,打开面板看一眼就知道了。

一个项目可以有多个端口。 seckill 那行显示的是 4173 +10,因为它是个多模块项目,主服务之外还挂着 10 个端口。面板会把一堆监听端口收敛成一个主端口显示,需要的时候再展开,不会让端口列表变成一坨。

内存是真的能看清。 11 个服务里,大部分都在 10~20MB:qwen-workbench 3MB、ok-crm前端 9MB、大衍众生途 10MB。也有大的——emotion-backend 352MB、seckill 941MB,都是 Java 进程,这个量级是正常的。以前这些数字只能靠 ps aux | grep 猜,现在一眼就看到谁是大头。

日志。 点开「日志」是在面板里直接看的,支持自动滚动、清空、下载、全屏。左边选项目、右边看日志,不用切终端——下面这张图右侧展开的就是 emotion-backend 的运行日志:

f329328c46d8ef4bc8c21ecaf6026327.png

登记一个项目长什么样

只有一张表单,一条启动命令就行:

23aca253337e8a65c064952a86eb9f59.png 几个设计上的取舍:

  • 启动命令必须以 cd <绝对路径> && 开头,因为面板要靠这个 cwd 去反查端口和进程归属。填完后表单会自动解析出「执行目录」
  • 端口留空自动探测,填了就当「钉端口」用。表单下面会显示「本记录认领:*:8080」,还会给你提示认领点,避免两个项目抢同一个端口
  • 环境变量可以直接写 JAVA_HOME=...,解决非登录 shell 里 PATH 不全、找不到 mvn / node 的问题
  • 停止命令可选:有些服务不是 kill 掉就行的,可以填自己的停止脚本;留空就走默认的杀进程组
  • 日志文件可选:项目自己往文件里写日志的话填上路径,面板直接读那个文件,不是只看 stdout

域名这块是怎么接的

这是我觉得省事最多的地方。面板接了 Cloudflare Tunnel(见上面【图 3】表单下半部分):

选 Tunnel 而不是「买服务器 + 自建 Nginx」,还有一层考虑:它不需要公网 IP,也不需要多一台服务器。 我本机的服务直接就能挂到域名上——对「不想花钱的尝试阶段」来说,这个组合刚好够用,除了域名本身,没有额外的固定开销。

配一次 API Token 之后,面板会同步你账号里的 tunnel 和域名映射。给某个项目绑定域名,就是填个前缀、点「绑定」——它会自动创建 tunnel、写 ingress 规则、加 DNS 记录。解绑也是对称的,会把规则和 DNS 记录摘干净。

我目前的 onekey-ai.top 下面挂了 6 条映射,对应面板上不同项目:eng. 给 word-battle、okcrm. 给 ok-crm、dayan. 给大衍众生途、www. 给 emotion-backend……以前这些每一条都要手动改一遍 Nginx 配置和证书,现在是在面板上点一下。

几个踩过的坑(如果你也想写类似的工具)

这部分是我觉得最有价值的地方,都是实际调试出来的:

1. 平台的进程退出了,子进程必须还能活。

最直觉的做法是 spawn 时用 pipe 接 stdout,然后自己转到文件。但这样平台一退出,子进程往 stdout 写就会收到 SIGPIPE 直接死掉——而需求恰恰是「平台关了,项目还在跑」。最后的做法是子进程 detached,并且 stdio 直接指向日志文件的 fd,不经过 pipe。

2. 停止时不能留孤儿进程。

只 kill 父 PID 是不够的。npm run dev 会派生一堆子进程,父进程死了它们会变孤儿,继续占着端口。所以子进程要 detached 成进程组组长(pgid === pid,这是内核保证的),停止时用 process.kill(-pid) 一次干掉整棵树。另外一定要加一道安全闸:绝对不能对面板自己所在的进程组下手,否则等于自杀。

3. 平台重启后要能认回项目,又不能误杀。

重启后靠 PID 记录去认项目,风险是 PID 被系统复用,认错就会误杀掉别人的进程。所以做了三重校验:PID 还活着 + 进程的 cwd 和登记的一致 + ps 里的启动时间对得上。

4. 端口是「按工作目录反查」出来的,不是启动时记下来的。

这是整个工具最有用的一招。用 lsof 拿到所有处于 LISTEN 的 TCP 端口和对应进程,再批量拿这些进程的 cwd,匹配上就是你项目的端口。好处是不依赖 ps,而且对「终端里手动启动的进程」和「平台启动的进程」一视同仁——这就是前面「外部启动」标签能成立的原因。

还有个容易踩的细节:macOS 上 127.0.0.1 和 ::1 是两个不同的 socket,内核允许它们同时监听同一个端口号。所以判断端口冲突必须同时带上绑定地址,只看端口号会误判。

5. 有些服务你根本停不掉。

launchd 和 pm2 这类守护进程会发现你杀了它托管的进程,然后立刻把它拉起来。用户看到的表象就是「点了停止,过两秒它又活了」。所以面板专门做了守护进程探测,在这种情况下会明确告诉你「这个是被 launchd 托管的」,而不是让你以为是 bug。

它不做什么

我想把这个说清楚,因为它决定了什么场景该用它、什么场景不该:

能力Docker / K8sdev-hub
上手成本写 Dockerfile / compose、构建镜像登记一条命令
环境隔离(两个项目要不同 JDK / Node 版本)核心能力不解决
可复现(换机器、给同事)核心能力不解决
资源限制、网络隔离cgroup / namespace不解决
健康检查、自动重启、自愈有不做,交给 launchd / pm2
开发机上跑一组临时项目、用完就停可以但重主要场景

所以它的适用范围就一条:我自己这台 macOS 上的临时项目。 一旦涉及协作、交付、线上运行,请回到 Docker。

技术上有几个硬约束也说在前面:只支持 macOS(依赖系统自带的 lsof 和 ps),需要 Node.js 18+,只绑 127.0.0.1 不带鉴权(因为它就是个本机工具)。

其他细节

  • 零依赖:只用 Node 内置模块,没有 node_modules,不需要 npm install
  • 不常驻:前台运行,Ctrl+C 即停。面板自己不是守护进程,关了不影响已经启动的项目
  • 数据是纯文本:data/projects.json(登记表)、data/runtime.json(运行状态)、data/logs/<id>.log(日志),可以直接改
  • 自带一个 skill + CLI:可以让 AI 助手直接查状态、启停服务、看日志,不想装也能当命令行用
  • 顺手做了个扫描:能把当前正在跑的服务扫出来,勾选批量导入,不用一个个手填

最后

说个不太好听的实话。

我之前的项目,我也做了推广——发帖、转发、小范围传播,能试的都试过一轮。结果是基本没什么水花。

但比「没人用」更扎心的是另一件事:推广完之后,我自己也不怎么点开。 一个连自己都不用的东西,凭什么指望别人用?我后来才想明白,那批项目从做出来的那一刻起就注定是死的,因为需求本来就不成立——是我觉得「这个应该有人需要」,而不是我自己每天都需要。

这个项目是唯一的例外。它跟我之前那些不一样的地方只有一个:我不用它就不放心。 每天打开电脑会先点一下,看有没有哪个服务还在后台偷偷跑着、哪个端口被谁占着。它解决的甚至算不上大问题,就是一个很小、但每天都要出现一次的麻烦。正因为我自己每天都要面对它,它就没法被搁置。

所以我现在判断一个项目值不值得继续做,只看一个指标:在我还没有向任何人推广它的时候,我自己会不会每天点开它。 如果不会,那推广能带来的一切都是假的。

仓库在这里,代码量不到 4000 行,欢迎吐槽和提 issue:

github.com/xiajingg/de…

附:快速开始

git clone https://github.com/xiajingg/dev-hub.git
cd dev-hub
./start.sh

然后浏览器打开 http://127.0.0.1:4321 就行。换端口用 PORT=4322 ./start.sh。