电脑本地部署
目标:在 Windows 电脑上用 cmd 跑起 danmu_api。这页从依赖安装开始写,按顺序做完后,浏览器可以打开 http://127.0.0.1:9321。
这页只讲 Windows 10 / 11 的 cmd 主线。命令一条一条复制,等上一条执行完、命令行重新出现提示符,再继续下一条。
第 1 步:打开 cmd
Section titled “第 1 步:打开 cmd”按这个顺序做:
- 按键盘上的
Win键 - 输入
cmd - 点
命令提示符

cmd,后面所有命令都在这个窗口里执行。第 2 步:安装 Git
Section titled “第 2 步:安装 Git”Git 用来从 GitHub 下载代码。先在 cmd 里执行:
winget install --id Git.Git -e如果中途出现协议确认,输入:
y然后回车继续。
已成功安装 或类似完成提示后,再继续安装 Node.js。如果提示 winget 不是内部或外部命令,就打开 Git 官网下载 Windows 安装包,安装时保持默认选项一路继续:git-scm.com/download/win。
第 3 步:安装 Node.js LTS
Section titled “第 3 步:安装 Node.js LTS”继续在同一个 cmd 里执行:
winget install OpenJS.NodeJS.LTS如果弹出源协议确认,输入 y,再回车。
node -v,下一步要重新打开 cmd。
y 再回车。
cmd。如果不能用 winget,就打开 Node.js 官网下载 LTS 版本安装包,安装时保持默认选项一路继续:nodejs.org/en/download。
第 4 步:重新打开 cmd,并检查依赖版本
Section titled “第 4 步:重新打开 cmd,并检查依赖版本”安装 Git 和 Node.js 后,先把刚才的 cmd 关掉,再重新打开一个新的 cmd。
在新的 cmd 里按顺序执行:
git --versionnode -vnpm -v如果 node -v 或 npm -v 仍然提示找不到命令,通常是安装后没有重新打开 cmd;先关掉窗口,再重新打开一个新的 cmd 重试。
第 5 步:下载 danmu_api 代码
Section titled “第 5 步:下载 danmu_api 代码”先回到当前 Windows 用户目录:
cd /d %USERPROFILE%再下载代码:
git clone https://github.com/huangxd-/danmu_api.git下载完成后进入项目目录:
cd danmu_apidanmu_api 目录里执行;看到提示符里出现 danmu_api> 再继续。如果提示 destination path ‘danmu_api’ already exists,说明以前下载过这个文件夹。最简单的处理方式是换一个新目录重新下载:
cd /d %USERPROFILE%git clone https://github.com/huangxd-/danmu_api.git danmu_api_newcd danmu_api_new第 6 步:安装项目依赖
Section titled “第 6 步:安装项目依赖”确认当前目录在 danmu_api 或 danmu_api_new 后,执行:
npm install如果这里下载很慢,先等几分钟;只要没有红色报错,继续等它完成即可。
第 7 步:复制 config/.env 并打开
Section titled “第 7 步:复制 config/.env 并打开”下面两条命令都要在项目目录里执行。
先复制配置文件:
copy config\.env.example config\.env再用记事本打开:
notepad config\.envnotepad config\.env 后,会弹出 Windows 记事本。如果系统提示找不到文件,说明当前目录不对。先回到项目目录:
cd /d %USERPROFILE%\danmu_api如果你前面用的是 danmu_api_new,就执行:
cd /d %USERPROFILE%\danmu_api_new然后重新执行复制和打开配置文件的命令。
第 8 步:只改 TOKEN 和 ADMIN_TOKEN
Section titled “第 8 步:只改 TOKEN 和 ADMIN_TOKEN”记事本打开后,先只改这两项:
TOKEN=你的普通访问令牌ADMIN_TOKEN=你的管理员令牌如果你看到的是:
# ADMIN_TOKEN=***就把最前面的 # 删除,再把后面的值改成自己的管理员令牌。

TOKEN 和 ADMIN_TOKEN。改完后按 Ctrl + S 保存,再关闭记事本。这两个值这样用:
TOKEN:普通页面和接口访问用ADMIN_TOKEN:管理员页面用;不设置就打不开管理员功能
第 9 步:启动 danmu_api
Section titled “第 9 步:启动 danmu_api”回到项目目录里的 cmd,执行:
npm startServer 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,执行:
ipconfig在当前正在联网的网卡下面找 IPv4 地址 或 IPv4 Address。
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 地址。

系统配置 里改。电脑本地部署这条线大多数配置支持热更新。如果只想手动改文件,也可以回到项目目录打开:
notepad config\.env改完保存后,大多数配置会自动重新加载;如果改的是端口,按 Ctrl + C 停掉当前服务,再重新执行 npm start。
第 12 步:做部署后自检
Section titled “第 12 步:做部署后自检”服务启动后,继续按 部署后自检 检查首页、弹幕测试和管理员入口。电脑自己测试用 127.0.0.1;局域网设备测试时,把 127.0.0.1 换成第 10 步查到的 IPv4 地址。
本页命令已按 huangxd-/danmu_api 当前 README.md、package.json、config/.env.example 和 danmu_api/server.js 核对。cmd 终端图为按实际命令整理的示例图,实际版本号和下载进度可能不同;安装确认、安装完成、环境变量和系统配置截图沿用实操截图。
纠错与建议
这一步有问题?
可以直接提交纠错或建议。我会按页面和步骤整理处理。
教程反馈