跳转至

电脑本地 Node.js 部署

从打开终端开始，安装 Git 和 Node.js，下载 danmu_api，修改配置，启动本地服务。

目标

在 Windows / macOS / Linux 电脑上跑起 danmu_api。按这页做完后，浏览器可以打开 http://127.0.0.1:9321。

命令一条一条复制，等上一条执行完、终端重新出现提示符，再继续下一条。

优缺点

优点 缺点
不需要任何云平台账号 需要电脑一直开着才能用
完全免费，无流量限制 其他设备只能在局域网内访问
配置文件直接在本地修改 需要手动安装 Git 和 Node.js
配置热更新，改完即生效 不适合长期无人值守运行

第 1 步：打开终端

按这个顺序做：

  1. 按键盘上的 Win 键
  2. 输入 cmd
  3. 点 命令提示符

打开 cmd

先打开 cmd，后面所有命令都在这个窗口里执行。

按这个顺序做：

  1. 按 Command + 空格
  2. 输入 终端 或 Terminal
  3. 点 终端.app

打开系统自带的终端应用。不同桌面环境入口位置不一样，一般在应用菜单里找 终端 或 Terminal。

第 2 步：安装 Git

在 cmd 里执行：

winget install --id Git.Git -e

如果中途出现协议确认，输入 y 然后回车。

安装 Git

看到 已成功安装 或类似完成提示后，再继续安装 Node.js。

如果提示 winget 不是内部或外部命令，就打开 Git 官网下载 Windows 安装包，安装时保持默认选项一路继续：git-scm.com/download/win。

macOS 一般自带 Git。如果没有，执行：

xcode-select --install

Linux（Debian / Ubuntu）执行：

sudo apt install -y git

第 3 步：安装 Node.js LTS

继续在同一个 cmd 里执行：

winget install OpenJS.NodeJS.LTS

如果弹出源协议确认，输入 y，再回车。

安装 Node.js

Node.js 安装完成后，先不要急着执行 node -v，下一步要重新打开 cmd。

安装确认

实际遇到这种协议确认时，输入 y 再回车。

安装成功

看到安装完成提示后，关闭当前 cmd。

如果不能用 winget，就打开 Node.js 官网下载 LTS 版本安装包，安装时保持默认选项一路继续：nodejs.org/en/download。

推荐用 nvm 安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

安装完后重新打开终端，再执行：

nvm install --lts

推荐用 nvm 安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

安装完后重新打开终端，再执行：

nvm install --lts

第 4 步：重新打开终端，并检查依赖版本

安装 Git 和 Node.js 后，先把当前终端关掉，再重新打开一个新的终端。

按顺序执行：

git --version

node -v

npm -v

检查版本

这 3 条都能显示版本号，说明依赖已经装好。版本号不需要和图里完全一样。

如果 node -v 或 npm -v 仍然提示找不到命令，通常是安装后没有重新打开终端；先关掉窗口，再重新打开一个新的终端重试。

第 5 步：下载 danmu_api 代码

先回到当前 Windows 用户目录：

cd /d %USERPROFILE%

先回到用户主目录：

cd ~

下载代码：

git clone https://github.com/huangxd-/danmu_api.git

下载完成后进入项目目录：

cd danmu_api

下载代码

后面所有命令都要在 danmu_api 目录里执行；看到提示符里出现 danmu_api 再继续。

如果提示 destination path 'danmu_api' already exists，说明以前下载过这个文件夹。最简单的处理方式是换一个新目录重新下载：

git clone https://github.com/huangxd-/danmu_api.git danmu_api_new
cd danmu_api_new

第 6 步：安装项目依赖

确认当前目录在 danmu_api 或 danmu_api_new 后，执行：

npm install

安装依赖

依赖安装需要等一会儿。看到终端重新回到项目目录提示符，再继续。

如果这里下载很慢，先等几分钟；只要没有红色报错，继续等它完成即可。

第 7 步：复制 config/.env 并打开

先复制配置文件：

copy config\.env.example config\.env

再用记事本打开：

notepad config\.env

复制配置

执行 notepad config\.env 后，会弹出 Windows 记事本。

先复制配置文件：

cp config/.env.example config/.env

再用 nano 打开：

nano config/.env

如果提示找不到文件，说明当前目录不对。先回到项目目录：

cd ~/danmu_api

第 8 步：只改 TOKEN 和 ADMIN_TOKEN

编辑器打开后，先只改这两项：

TOKEN=你的普通访问令牌
ADMIN_TOKEN=你的管理员令牌

如果你看到的是 # ADMIN_TOKEN=***，就把最前面的 # 删除，再把后面的值改成自己的管理员令牌。

修改配置

先只确认 TOKEN 和 ADMIN_TOKEN。改完后保存关闭编辑器。

这两个值这样用：

  • TOKEN：普通页面和接口访问用
  • ADMIN_TOKEN：管理员页面用；不设置就打不开管理员功能

按 Ctrl + S 保存，再关闭记事本。

nano 里按 Ctrl + O → 回车 → Ctrl + X 保存退出。

第 9 步：启动 danmu_api

回到项目目录里的终端，执行：

npm start

启动服务

看到 Server running on http://0.0.0.0:9321，说明服务已经启动。这个终端窗口要保持打开。

现在打开浏览器访问：

http://127.0.0.1:9321

如果你设置了自己的 TOKEN，也可以直接打开：

http://127.0.0.1:9321/你的TOKEN

第 10 步：需要局域网访问时，查电脑 IPv4 地址

如果只在这台电脑上测试，用 127.0.0.1 就够了。

如果同一个 Wi-Fi / 路由器下的手机、平板、电视盒子也要访问，保持运行 npm start 的窗口不要关，再打开第二个终端。

执行：

ipconfig

在当前正在联网的网卡下面找 IPv4 地址。

查看 IP

图里示例 IP 是 192.168.1.23，所以局域网访问地址就是 http://192.168.1.23:9321。

执行：

ifconfig | grep "inet "

找 en0 或 en1 下面的 inet 地址。

执行：

ip -4 addr show | grep inet

找局域网网段的地址（通常是 192.168.x.x、10.x.x.x 或 172.16.x.x）。

实际访问时，把示例 IP 换成你电脑上看到的 IPv4 地址：

http://你的IPv4地址:9321

如果手机打不开，先确认手机和电脑在同一个 Wi-Fi；再检查防火墙是否拦截了 Node.js。

第 11 步：以后改变量，进前端系统配置

服务跑起来后，后面大多数变量可以在前端改。

管理员地址是：

http://127.0.0.1:9321/你的ADMIN_TOKEN

如果是局域网其他设备访问，就把 127.0.0.1 换成第 10 步查到的 IPv4 地址。

系统配置

以后改变量，优先在 系统配置 里改。电脑本地部署这条线大多数配置支持热更新。

如果只想手动改文件，也可以回到项目目录打开 config/.env 修改。改完保存后，大多数配置会自动重新加载；如果改的是端口，按 Ctrl + C 停掉当前服务，再重新执行 npm start。

常见问题

1）node -v 或 npm -v 提示找不到命令

通常是安装后没有重新打开终端。先关掉窗口，再重新打开一个新的终端重试。

2）npm install 下载很慢

先等几分钟，只要没有红色报错就继续等。如果实在太慢，可以尝试设置国内镜像：

npm config set registry https://registry.npmmirror.com

然后重新执行 npm install。

3）手机打不开电脑地址

先确认：

  • 手机和电脑在同一个 Wi-Fi
  • 填的是第 10 步查到的局域网 IP，不是 127.0.0.1
  • Windows 防火墙没有拦截 Node.js

下一步