跳转到内容
搜教程里的步骤和配置项 例如 Vercel、Docker、TOKEN、播放器、域名。

电脑本地部署

目标:在 Windows 电脑上用 cmd 跑起 danmu_api。这页从依赖安装开始写,按顺序做完后,浏览器可以打开 http://127.0.0.1:9321

这页只讲 Windows 10 / 11 的 cmd 主线。命令一条一条复制,等上一条执行完、命令行重新出现提示符,再继续下一条。

按这个顺序做:

  1. 按键盘上的 Win
  2. 输入 cmd
  3. 命令提示符
Windows 开始菜单里搜索 cmd 并打开命令提示符的截图
先打开 cmd,后面所有命令都在这个窗口里执行。

Git 用来从 GitHub 下载代码。先在 cmd 里执行:

Terminal window
winget install --id Git.Git -e

如果中途出现协议确认,输入:

y

然后回车继续。

cmd 里通过 winget 安装 Git 的终端示例图
看到 已成功安装 或类似完成提示后,再继续安装 Node.js。

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

继续在同一个 cmd 里执行:

Terminal window
winget install OpenJS.NodeJS.LTS

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

cmd 里通过 winget 安装 Node.js LTS 的终端示例图
Node.js 安装完成后,先不要急着执行 node -v,下一步要重新打开 cmd
Windows 命令提示符里安装 Node.js 时弹出源协议确认的截图
实际遇到这种协议确认时,输入 y 再回车。
Windows 命令提示符里通过 winget 安装 Node.js 成功后的截图
看到安装完成提示后,关闭当前 cmd

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

第 4 步:重新打开 cmd,并检查依赖版本

Section titled “第 4 步:重新打开 cmd,并检查依赖版本”

安装 Git 和 Node.js 后,先把刚才的 cmd 关掉,再重新打开一个新的 cmd

在新的 cmd 里按顺序执行:

Terminal window
git --version
Terminal window
node -v
Terminal window
npm -v
cmd 里检查 Git、Node.js 和 npm 版本号的终端示例图
这 3 条都能显示版本号,说明依赖已经装好。版本号不需要和图里完全一样。

如果 node -vnpm -v 仍然提示找不到命令,通常是安装后没有重新打开 cmd;先关掉窗口,再重新打开一个新的 cmd 重试。

先回到当前 Windows 用户目录:

Terminal window
cd /d %USERPROFILE%

再下载代码:

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

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

Terminal window
cd danmu_api
cmd 里执行 git clone 并进入 danmu_api 目录的终端示例图
后面所有命令都要在 danmu_api 目录里执行;看到提示符里出现 danmu_api> 再继续。

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

Terminal window
cd /d %USERPROFILE%
Terminal window
git clone https://github.com/huangxd-/danmu_api.git danmu_api_new
Terminal window
cd danmu_api_new

确认当前目录在 danmu_apidanmu_api_new 后,执行:

Terminal window
npm install
cmd 里执行 npm install 安装依赖的终端示例图
依赖安装需要等一会儿。看到命令行重新回到项目目录提示符,再继续。

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

下面两条命令都要在项目目录里执行。

先复制配置文件:

Terminal window
copy config\.env.example config\.env

再用记事本打开:

Terminal window
notepad config\.env
cmd 里复制 config/.env 并用记事本打开的终端示例图
执行 notepad config\.env 后,会弹出 Windows 记事本。

如果系统提示找不到文件,说明当前目录不对。先回到项目目录:

Terminal window
cd /d %USERPROFILE%\danmu_api

如果你前面用的是 danmu_api_new,就执行:

Terminal window
cd /d %USERPROFILE%\danmu_api_new

然后重新执行复制和打开配置文件的命令。

记事本打开后,先只改这两项:

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

如果你看到的是:

# ADMIN_TOKEN=***

就把最前面的 # 删除,再把后面的值改成自己的管理员令牌。

记事本里填写 config/.env 的 TOKEN 和 ADMIN_TOKEN 的截图
先只确认 TOKENADMIN_TOKEN。改完后按 Ctrl + S 保存,再关闭记事本。

这两个值这样用:

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

回到项目目录里的 cmd,执行:

Terminal window
npm start
cmd 里执行 npm start 并启动 danmu_api 的终端示例图
看到 Server running on http://0.0.0.0:9321,说明服务已经启动。这个 cmd 窗口要保持打开。

现在打开浏览器访问:

http://127.0.0.1:9321

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

http://127.0.0.1:9321/你的TOKEN

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

Section titled “第 10 步:需要局域网访问时,查电脑 IPv4 地址”

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

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

Terminal window
ipconfig

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

cmd 里执行 ipconfig 查看局域网 IPv4 地址的终端示例图
图里示例 IP 是 192.168.1.23,所以局域网访问地址就是 http://192.168.1.23:9321

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

http://你的IPv4地址:9321

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

第 11 步:以后改变量,进前端系统配置

Section titled “第 11 步:以后改变量,进前端系统配置”

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

管理员地址是:

http://127.0.0.1:9321/你的ADMIN_TOKEN

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

用户实际操作时在管理员 UI 里打开系统配置页面的截图
以后改变量,优先在 系统配置 里改。电脑本地部署这条线大多数配置支持热更新。

如果只想手动改文件,也可以回到项目目录打开:

Terminal window
notepad config\.env

改完保存后,大多数配置会自动重新加载;如果改的是端口,按 Ctrl + C 停掉当前服务,再重新执行 npm start

服务启动后,继续按 部署后自检 检查首页、弹幕测试和管理员入口。电脑自己测试用 127.0.0.1;局域网设备测试时,把 127.0.0.1 换成第 10 步查到的 IPv4 地址。

本页命令已按 huangxd-/danmu_api 当前 README.mdpackage.jsonconfig/.env.exampledanmu_api/server.js 核对。cmd 终端图为按实际命令整理的示例图,实际版本号和下载进度可能不同;安装确认、安装完成、环境变量和系统配置截图沿用实操截图。