vox/README.md

Vox (词脉)

智能单词挑战系统。

• 极速：Svelte 5 + Tailwind 4
• 智能：错题本 + 专项练习
• 持久：SQLite 存储

npm i && npm run dev # Port: 1995

Docker

1. 使用 Docker CLI

docker build -t vox-app .
docker run -p 1995:1995 -v $(pwd)/data.db:/app/data.db vox-app

2. 使用 Docker Compose (推荐)

# 以后台模式运行
docker-compose up -d
# 查看日志
docker-compose logs -f

3. 先编译后打包 (推荐：适用于性能较弱的服务器)

在本地预先编译，仅将结果推送到容器，可极大地减少部署时间。

# 1. 本地编译
npm install
npm run build

# 2. 使用精简版 Dockerfile 构建
docker build -t vox-fast -f Dockerfile.fast .

# 3. 运行
docker run -p 1995:1995 -v $(pwd)/data.db:/app/data.db vox-fast

4. 发布与分发 (镜像分发模式)

如果您想让其他用户像下载标准镜像一样直接使用：

# 1. 运行发布脚本（执行本地编译 + 镜像打包）
./release.sh

# 2. 推送到您的 Gitea 注册表
docker push gitea.qxy1828.com/chaos/vox:latest

用户端只需：

docker pull gitea.qxy1828.com/chaos/vox:latest
docker run -p 1995:1995 -v /path/to/data.db:/app/data.db gitea.qxy1828.com/chaos/vox:latest