Windows 手动运行 OpenList 单文件版:下载、启动与注册服务
Windows 用户有两条路:想要图形界面就用 桌面版;想保持轻量、只跑一个进程,就按本页手动运行单文件版。
第一步:下载对应架构的二进制
到官方下载页(文档「安装 - 下载」一页,或项目的 GitHub Releases)选择 Windows 平台的压缩包:
- 常见 64 位电脑选
windows-amd64 - ARM 设备(如部分笔记本)选
windows-arm64
下载后解压,里面就是一个 openlist.exe。
第二步:放到固定目录并启动
给程序安排一个固定目录,例如 D:\openlist\,把 exe 放进去。然后在这个目录里打开终端:
- 在文件资源管理器进入
D:\openlist\,顶部地址栏输入cmd回车,终端就会自动定位到当前目录
执行:
.\openlist.exe server
看到日志输出、提示监听 5244 端口即启动成功,浏览器访问 localhost:5244。
第三步:拿密码、进后台
首次启动会在日志里打印 admin 初始密码;忘记或错过了就在同一目录执行 .\openlist.exe admin random 重置。密码命令必须在程序目录里跑,原因见 登录排查。
让它常驻:注册为 Windows 服务
手动方式关掉终端程序就停了。两种常驻方案:
- 推荐:改用桌面版,它内置了服务安装、开机自启和系统托盘
- 进阶:用 nssm、WinSW 等第三方服务包装器把
openlist.exe server注册成 Windows 服务(社区教程较多,按工具文档操作)
目录纪律(重要)
OpenList 一切数据——数据库、配置、日志、临时文件——都存在启动时所在目录的 data 文件夹里。所以:
- 别从「下载文件夹」直接双击运行,否则数据散落难以备份
- 备份 = 备份整个程序目录(详见 备份与恢复)
- 升级 = 换新的 exe,
data文件夹不动