@pinixai/pier-exit
v0.1.0
Published
Let your Cloud Pier browsers go out through this computer's network (Pier exit).
Readme
@pinixai/pier-exit
让你 Pinix 账号里的 Cloud Pier(云端浏览器)经过这台电脑的网络上网:网站看到的是这台电脑的 IP,这台电脑上的代理(比如 Clash)也同样对它生效。
npx @pinixai/pier-exit第一次运行会给出一个链接。在浏览器里打开、确认以后,这台电脑就成了你的出口,同时自动建好一个同名的网络,名字就是这台电脑的名字。打开 pier.pinixai.com 的 Profiles 页,在「网络」里就能看到它;给 profile 选上这个网络就行,也可以在那里改名。删掉这个网络,就停用这台电脑。
想让它一直开着(开机自动运行、断了自己重启),再运行一次:
npx @pinixai/pier-exit install它会做什么、不会做什么
- 只往外连:连 Pinix 的 API,再连中继。这台电脑上不开任何端口。
- 只替你自己账号的云浏览器连网站。终端里一直显示「这台电脑正在给 <账号> 当出口」,以及今天的流量。
- 不连这台电脑本身、局域网(10.x、192.168.x、172.16–31.x…)、云厂商的元数据地址,也不连 25 端口(发邮件)。
- 域名用这台电脑自己的 DNS 解析,所以本机代理的分流规则照常生效。
- 关掉终端,出口就下线了,云浏览器会报
EXIT_OFFLINE;再运行一次就恢复。
流量额度
每个出口每月默认最多经它走 30 GB(上下行合计,按北京时间的自然月算)。字节数由 Pinix 的中继统计,不是这台电脑自己报的。用完以后,出口断开,终端显示「这个出口本月的流量用完了」,云浏览器报 EXIT_QUOTA_EXCEEDED,不会改用直连。下个月 1 号自动恢复,不用重新运行。
命令
| 命令 | 作用 |
|---|---|
| npx @pinixai/pier-exit | 没登录先登录,然后运行 |
| npx @pinixai/pier-exit login [--name 名字] | 重新登录(名字默认取电脑名,即「系统设置 → 通用 → 关于本机」里的名称) |
| npx @pinixai/pier-exit status | 看当前登录,以及是否在后台常驻 |
| npx @pinixai/pier-exit install | 在后台常驻(macOS):开机、登录后自动运行,断了自己重启 |
| npx @pinixai/pier-exit uninstall | 停止后台常驻,登录保留 |
| npx @pinixai/pier-exit logout | 删掉这台电脑上的登录。要彻底停用,请在 pier.pinixai.com 删掉这个网络 |
登录信息存在 ~/.config/pinix-exit/credentials.json(权限 600),只能当这一个出口用。用 npm i -g @pinixai/pier-exit 全局安装以后,命令可以直接写成 pier-exit(旧名字 pinix-exit 也还能用)。这个包以前叫 pinix-exit,登录信息、常驻任务和日志的位置都没变,换成新名字不用重新登录。
需要 Node.js 22 或更新的版本,没有其他依赖。
后台常驻(macOS)
install 把程序复制到 ~/Library/Application Support/pinix-exit/(npx 的缓存会被清理),用 launchd 的 LaunchAgent ai.pinix.exit 运行,日志在 ~/Library/Logs/pinix-exit.log。它用的是运行 install 时的那个 node:换了 node 版本(比如 nvm 删掉了旧版本)之后,要再运行一次 install。登录被吊销或出口名字不允许时,它会在日志里说明并停下,不会反复重试;其他原因断了,30 秒后重启。
