142 lines
2.7 KiB
Markdown
142 lines
2.7 KiB
Markdown
# ToolsShow 项目 Docker 运行指南（仅 `docker run`）
|
||
|
||
本文档只针对当前项目，使用 `docker build` + `docker run` 启动，不使用 Compose。
|
||
|
||
## 1. 前提
|
||
|
||
- 已安装 Docker
|
||
- 在项目根目录执行命令：`C:/Users/User/WebstormProjects/ToolsShow`
|
||
|
||
先验证 Docker：
|
||
|
||
```bash
|
||
docker version
|
||
```
|
||
|
||
## 2. 准备环境变量文件
|
||
|
||
本项目后端需要 `.env`。推荐直接基于模板创建：
|
||
|
||
```bash
|
||
cp server/.env.example server/.env
|
||
```
|
||
|
||
Windows PowerShell 可用：
|
||
|
||
```powershell
|
||
Copy-Item server/.env.example server/.env
|
||
```
|
||
|
||
至少确认以下项存在（`server/.env`）：
|
||
|
||
```env
|
||
PORT=3000
|
||
DATABASE_URL="file:./dev.db"
|
||
JWT_ACCESS_SECRET=change_this_access_secret
|
||
JWT_REFRESH_SECRET=change_this_refresh_secret
|
||
```
|
||
|
||
说明：
|
||
|
||
- 当前项目 Prisma 使用 `SQLite`（`server/prisma/schema.prisma`）。
|
||
- `DATABASE_URL="file:./dev.db"` 对应数据库文件在容器内路径 `/app/server/prisma/dev.db`。
|
||
|
||
## 3. 构建镜像
|
||
|
||
在项目根目录执行：
|
||
|
||
```bash
|
||
docker build -t toolsshow:latest .
|
||
```
|
||
|
||
## 4. 启动容器（只用 docker run）
|
||
|
||
### 4.1 最小启动命令
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name toolsshow-app \
|
||
-p 3000:3000 \
|
||
--env-file ./server/.env \
|
||
toolsshow:latest
|
||
```
|
||
|
||
### 4.2 推荐启动命令（带 SQLite 持久化）
|
||
|
||
建议挂载 `server/prisma`，保证数据库文件重建容器后仍保留：
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name toolsshow-app \
|
||
-p 3000:3000 \
|
||
--env-file ./server/.env \
|
||
-v toolsshow_prisma:/app/server/prisma \
|
||
toolsshow:latest
|
||
```
|
||
|
||
说明：
|
||
|
||
- 容器启动命令已在 `Dockerfile` 中定义：`npx prisma migrate deploy && node dist/main`。
|
||
- 首次启动会自动执行数据库迁移。
|
||
|
||
## 5. 常用运维命令
|
||
|
||
查看运行状态：
|
||
|
||
```bash
|
||
docker ps
|
||
```
|
||
|
||
查看日志：
|
||
|
||
```bash
|
||
docker logs -f toolsshow-app
|
||
```
|
||
|
||
停止/启动容器：
|
||
|
||
```bash
|
||
docker stop toolsshow-app
|
||
docker start toolsshow-app
|
||
```
|
||
|
||
删除容器（不会删除命名卷）：
|
||
|
||
```bash
|
||
docker rm -f toolsshow-app
|
||
```
|
||
|
||
查看卷：
|
||
|
||
```bash
|
||
docker volume ls
|
||
```
|
||
|
||
删除 SQLite 数据卷（危险操作，会清数据）：
|
||
|
||
```bash
|
||
docker volume rm toolsshow_prisma
|
||
```
|
||
|
||
## 6. 访问地址
|
||
|
||
- 应用地址：`http://localhost:3000`
|
||
- 若启动后无法访问，请先看日志：`docker logs toolsshow-app`
|
||
|
||
## 7. 一次性复制命令（推荐）
|
||
|
||
```bash
|
||
docker build -t toolsshow:latest . && \
|
||
docker rm -f toolsshow-app 2>/dev/null || true && \
|
||
docker run -d --name toolsshow-app -p 3000:3000 --env-file ./server/.env -v toolsshow_prisma:/app/server/prisma toolsshow:latest
|
||
```
|
||
|
||
PowerShell 对应写法：
|
||
|
||
```powershell
|
||
docker build -t toolsshow:latest .
|
||
docker rm -f toolsshow-app 2>$null
|
||
docker run -d --name toolsshow-app -p 3000:3000 --env-file ./server/.env -v toolsshow_prisma:/app/server/prisma toolsshow:latest
|
||
```
|
||
|