运行 9Router 以及将其配置为在后台持续运行非常简单。根据项目的官方文档,你可以通过以下几种方式进行操作:
一、 基础运行方式(前台运行)
如果你只是想在本地快速启动它,有以下两种选择:
- 全局安装(最快):
打开终端执行npm install -g 9router,安装完成后直接输入9router即可启动服务。此时仪表板将在http://localhost:20128打开。 - 从源码运行:
在项目根目录下,先执行npm install安装依赖。- 开发模式:
npm run dev - 生产模式:先执行
npm run build,然后再执行npm run start
源码下载地址:https://github.com/decolua/9router
(注意:前台运行的话,如果你关闭了终端窗口,服务就会停止。)
- 开发模式:
二、 如何配置后台运行(推荐)
如果你是在 VPS、云服务器上部署,或者希望它在你的电脑上静默运行,推荐使用 PM2 或 Docker 这两种方式来实现后台驻留:
方法一:使用 PM2 守护进程(适合 VPS 或本地 Node 环境)
PM2 是一个 Node.js 应用程序的生产环境进程管理器,自带后台运行和崩溃重启功能。
在项目源码目录下,依次执行以下命令:
bash
# 1. 全局安装 pm2
npm install -g pm2
# 2. 以后台方式启动 9router
pm2 start npm --name 9router -- start
# 3. 保存当前正在运行的进程列表
pm2 save
# 4. 设置为开机自启
pm2 startup
**
这样配置后,9Router 就会在后台稳定运行,并且每次重启电脑/服务器后也会自动启动。
方法二:使用 Docker(一键部署且原生支持后台运行)
如果你更喜欢使用容器化部署,Docker 命令中的 -d 参数天然就是用来让容器在后台运行的。
在项目根目录下执行:
bash
# 1. 构建 Docker 镜像
docker build -t 9router .
# 2. 运行容器(-d 参数即代表后台运行)
docker run -d \
--name 9router \
-p 20128:20128 \
--env-file ./.env \
-v 9router-data:/app/data \
-v 9router-usage:/root/.9router \
9router
**
如果后续需要查看后台的运行日志,可以使用命令 docker logs -f 9router。