项目简介
Remnawave Node Lite (Go) 是 Remnawave Panel 的轻量级 Node 实现。
如果你已经在用 Remnawave Panel 做节点管理,但不想在 VPS 上再套一层 Docker,或者希望在小内存机器上跑得更轻,这个项目可能适合你。
- 单一可执行文件 + 安装脚本,裸机直接部署
- 完整实现官方
@remnawave/node v2.7.0 的 28 条 REST API
- 支持 systemd(Debian/Ubuntu 等)和 OpenRC(Alpine)
- 当前版本:v1.0.2(2026-06-10 发布)
需要容器化部署请用官方 remnawave/node;本项目定位是裸机轻量。
为什么做这个
官方 Node 以 Docker 镜像为主,在以下场景里往往偏重:
场景 |
痛点 |
|---|
小内存 VPS(512M~1G) |
容器 + 镜像层额外占用 |
已有 systemd 运维习惯 |
不想为单个节点再维护 compose |
Alpine / OpenRC 环境 |
官方镜像生态偏 systemd |
追求部署透明 |
希望进程、日志、配置都在宿主机可见 |
Node Lite 用 Go 重写节点侧逻辑,配合 install-node.sh 一键安装,把 rw-core、服务单元、配置目录一次性配好。
主要特性
部署与运维
- 交互式安装菜单:安装 · 升级 · 卸载
- 非交互安装:环境变量传入
SECRET_KEY 即可
- 内置
remnanode-lite doctor 自检(端口、权限、rw-core、geo 文件等)
- 重启自动恢复:Panel 启用后写入
last-start.json,reboot 后自动拉起 rw-core
- 升级脚本保留
node.env 与现有 core,支持 RNL_UPGRADE_XRAY=1 同步升级 rw-core
功能对齐(Panel 2.7.x)
- 节点注册、mTLS / JWT 认证
- rw-core 生命周期管理(启动、停止、配置热更新)
- 流量统计、在线用户查询
- 用户热更新(VLESS / Trojan / Shadowsocks)
- 插件同步(nftables、torrent-blocker 等)
- Vision IP 封禁
近期 v1.0.x 亮点
- v1.0.0:生产验证通过,文档面向运维用户重写
- v1.0.1:内部 Token 不再出现在进程参数;Unix socket 权限加固;zstd 解压炸弹防护
- v1.0.2:JWT claim 校验增强;默认 body limit 降至 256MB;新增
NODE_BIND_ADDR 绑定监听地址
快速安装
Debian / Ubuntu(systemd)
curl -fsSL https://raw.githubusercontent.com/ike-sh/remnawave-node-lite-go/main/scripts/install-node.sh | sudo bash
Alpine(OpenRC)
apk add --no-cache curl bash
curl -fsSL https://raw.githubusercontent.com/ike-sh/remnawave-node-lite-go/main/scripts/install-node-alpine.sh -o /tmp/install-alpine.sh
bash /tmp/install-alpine.sh
接入流程
- 在 Panel 创建节点,复制
SECRET_KEY
- 运行安装脚本并粘贴 Secret Key
- 看到
OK: TCP :2222 已监听 后,在 Panel 启用节点(已启用则约 10s 内自动上线)
- 防火墙仅对 Panel 地址开放
NODE_PORT(默认 2222)
非交互示例:
SECRET_KEY='eyJ...' NODE_PORT=2222 \
curl -fsSL https://raw.githubusercontent.com/ike-sh/remnawave-node-lite-go/main/scripts/install-node.sh \
| sudo bash -s -- --yes
系统要求
- Linux(systemd 或 Alpine OpenRC)
- Panel 下发的
SECRET_KEY(含 mTLS 证书与 JWT 公钥)
- rw-core(安装脚本可自动安装)
- 可选:
nft、ss(插件 IP 封禁与连接踢除,需 CAP_NET_ADMIN)
运维常用命令
sudo remnanode-lite doctor
systemctl status remnawave-node
journalctl -u remnawave-node -f
xlogs
xerrors
配置文件:/etc/remnanode/node.env
技术栈
- 语言:Go
- 协议对齐:官方
@remnawave/node v2.7.0
- 数据面:rw-core(Xray-core 衍生)
- 许可:AGPL-3.0-only
链接
- 仓库:https://github.com/ike-sh/remnawave-node-lite-go
- 最新 Release:https://github.com/ike-sh/remnawave-node-lite-go/releases/tag/v1.0.2
- 变更日志:https://github.com/ike-sh/remnawave-node-lite-go/blob/main/docs/CHANGELOG.md
反馈
项目刚开源,欢迎 Star、Issue 和 PR。
如果你在 Panel 2.7.x 上跑过,尤其想听听:
- 小内存机器上的实际占用
- Alpine / OpenRC 环境的兼容性
- 与官方 Docker Node 的对比体验
有 bug 或功能建议直接提 Issue,感谢!