vox/README.md

Vox (词脉)

智能单词挑战系统。

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

npm i && npm run dev # Port: 1995

Docker

1. 使用 Docker CLI

# 关键：先在本地创建一个空文件，防止 Docker 将其识别为文件夹
touch data.db
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. 首先登录您的 Gitea 注册表 (仅需一次)
docker login gitea.qxy1828.com

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

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

推送到 GitHub

如果您想将代码推送到 GitHub：

# 1. 在 GitHub 上创建一个新仓库
# 2. 添加 GitHub 远端
git remote add github https://github.com/您的用户名/仓库名.git

# 3. 推送代码
git push -u github main

用户端只需：

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