4.1 单机部署(二进制 + SQLite)
单机部署(二进制 + SQLite)
独立部署模式无需 MySQL / Redis,使用 SQLite 持久化、内存缓存,适合个人或小型项目快速上手。
1. 下载二进制
前往 GitHub Releases 页下载对应平台的压缩包:
mkdir mliev-dwz && cd mliev-dwz
# Linux x86_64 为例
wget https://github.com/muleiwu/dwz-server/releases/latest/download/dwz-server_Linux_x86_64.tar.gz
tar -xzf dwz-server_Linux_x86_64.tar.gz
chmod +x dwz-server其它平台包括 Darwin_arm64、Darwin_x86_64、Windows_x86_64.zip 等。
2. 启动服务
# 前台运行(查看日志)
./dwz-server
# 后台运行
nohup ./dwz-server > dwz.log 2>&1 &默认监听 :8080,数据文件会自动生成在 ./config/sqlite.db。
3. 初始化安装
浏览器打开 http://127.0.0.1:8080,按向导步骤:
- 选择数据库驱动 =
sqlite,文件路径保持默认 - 选择缓存 =
local - 设置管理员账号密码
- 提交后等待自动迁移数据库
完成后页面会跳转到登录页,使用刚才创建的账号即可进入后台。
4. 健康检查
curl http://127.0.0.1:8080/health
curl http://127.0.0.1:8080/health/simple返回 200 即表示服务健康。
5. 后台入口
- 管理后台:
http://127.0.0.1:8080/admin/ - API 基础路径:
http://127.0.0.1:8080/api/v1/ - 短链接跳转:
http://127.0.0.1:8080/{code}
常见问题
- 8080 端口被占用:通过环境变量
SERVER_ADDR=:9090或config.yaml中的http.addr修改端口。 - 数据文件位置:独立模式下所有数据都在
./config/目录,备份/迁移直接打包该目录即可。 - 从 SQLite 迁移到 MySQL:请参考生产模式文档,导出后手动迁移,不建议在线切换。