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_arm64Darwin_x86_64Windows_x86_64.zip 等。

2. 启动服务

# 前台运行(查看日志)
./dwz-server

# 后台运行
nohup ./dwz-server > dwz.log 2>&1 &

默认监听 :8080,数据文件会自动生成在 ./config/sqlite.db

3. 初始化安装

浏览器打开 http://127.0.0.1:8080,按向导步骤:

  1. 选择数据库驱动 = sqlite,文件路径保持默认
  2. 选择缓存 = local
  3. 设置管理员账号密码
  4. 提交后等待自动迁移数据库

完成后页面会跳转到登录页,使用刚才创建的账号即可进入后台。

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=:9090config.yaml 中的 http.addr 修改端口。
  • 数据文件位置:独立模式下所有数据都在 ./config/ 目录,备份/迁移直接打包该目录即可。
  • 从 SQLite 迁移到 MySQL:请参考生产模式文档,导出后手动迁移,不建议在线切换。