it-tools

环境要求

• 已安装并运行 Docker（docker run 可用）
• 主机 8080 端口未被占用（或自行改用其他端口）
• 可选：本地开发/贡献代码需 Node.js 与 pnpm 环境

安装与启动步骤

1. 1启动 it-tools 容器

   从 Docker Hub 拉取官方镜像并后台运行，容器名 it-tools，宿主 8080 端口映射到容器 80 端口，并设置自动重启。

   docker run -d --name it-tools --restart unless-stopped -p 8080:80 corentinth/it-tools:latest

   复制

2. 2改用 GitHub 镜像源

   若 Docker Hub 拉取缓慢，可改用同一镜像的 GitHub Packages 地址，参数完全一致，两者任选其一。

   docker run -d --name it-tools --restart unless-stopped -p 8080:80 ghcr.io/corentinth/it-tools:latest

   复制

3. 3浏览器访问验证

   在浏览器打开 http://localhost:8080，能看到工具列表首页即部署成功。若在远程服务器部署，把 localhost 换成服务器 IP。

4. 4准备本地开发环境

   仅在需要参与开发或自行构建时需要。README 使用 pnpm 安装依赖，请在项目根目录执行。

   pnpm install

   复制

5. 5运行单元测试

   可选步骤，用 Vitest 执行单元测试，确认本地开发环境与代码改动正常。

   pnpm test

   复制

关键配置

如何确认成功

执行 docker ps 能看到 it-tools 容器处于 Up 状态，浏览器访问 http://localhost:8080 正常显示工具界面。

常见问题

注意事项

• README 只给出 Docker 自托管命令，未提供裸机源码构建部署流程，请勿自行臆造构建命令。
• 必须先安装 Docker 再执行 docker run，否则命令会直接报错。
• 参与代码贡献建议使用 VSCode 并安装 Volar、TypeScript Vue Plugin、ESLint、i18n Ally 插件，同时禁用 Vetur。
• 想快速体验而不部署，可直接访问官网 https://it-tools.tech。