300 lines
25 KiB
Markdown
300 lines
25 KiB
Markdown
# IT-TOOLS-PRO - 高级定制版工作者工具站:12个原创实用工具+卡密授权系统
|
||
|
||
基于开源项目 [IT-Tools](https://github.com/CorentinTh/it-tools)(GPLv3)深度定制的开发者/办公工具站,新增 **12 个原创实用工具**、**卡密授权系统**与数十项体验优化,全部功能持续更新中。
|
||
|
||
在线体验:https://it.88531.cn | 更多应用:https://nav.88531.cn
|
||
|
||
## 新增功能
|
||
|
||
### 原创工具(8 个)
|
||
|
||
| 工具 | 说明 |
|
||
|---|---|
|
||
| 📊 批量条码生成 | EAN/UPC/Code128/Code39/DataMatrix 等 12 种码制,批量生成打包下载,尺寸颜色字号可调 |
|
||
| 🔍 二维码条码识别 | 上传/拖拽/粘贴图片一键识别,多码混合批量输出,本地 WASM 解码不上传图片 |
|
||
| 🌐 在线翻译 | 中英日韩等 16 种语言互译,双线路自动切换,粘贴即译自动识别源语言 |
|
||
| 📷 图片OCR文字识别 | 本地 OCR 引擎,中文识别准确率 99%+,截图/扫描件文字一键提取 |
|
||
| 📄 PDF文字识别 | 逐页 OCR 中英文 PDF,每页预览翻页,一键复制或导出 TXT |
|
||
| 🏷️ 面单设计 | 快递面单模板开箱即用,支持 PDF 面单二次编辑(遮盖改字),300dpi 高清导出 |
|
||
| 🎨 AI修图 | 去水印/修复(涂抹智能填充)、抠图去背景、4x 超分辨率、人脸修复,本地 AI 模型秒级出图 |
|
||
| 🗂️ IT网站收藏 | 内置 91 个精选开发站点,数据存用户本地,支持自选目录同步 |
|
||
|
||
### 深度改造(3 个)
|
||
|
||
- **JSON 美化和格式化**:双栏专业工作台,左侧行号编辑、右侧树视图/语法高亮切换,含 Dict/Get参数/XML/CSV 等 7 种转换
|
||
- **PDF 工具**:合并/拆分/旋转/重排/压缩/加密/解密/水印/提取文本/页码/转图片,11 功能全程浏览器本地处理
|
||
- **图片工具**:压缩/转换/尺寸/裁剪/旋转/滤镜/打码/EXIF/二维码生成识别/水印/拼接,12 功能本地处理
|
||
|
||
### 授权与体验
|
||
|
||
- **卡密授权系统**:对接自建 CardAuth,高级功能每天免费试用 30 分钟,卡密激活全站通用,支持换卡密/自助撤销
|
||
- **授权介绍页**(/pricing):功能清单、购买优势、一键购买与机器码复制
|
||
- **生成记录**:翻译/OCR/修图/转换等 9 个工具自动留痕,数据存本地
|
||
- **体验优化**:全站中文默认、收藏与最近使用、菜单一键展开/收起、宽屏自适应、品牌页脚等数十项细节
|
||
|
||
### 留言反馈(2026.11 新增)
|
||
|
||
- **访客提交**:顶栏「留言反馈」按钮打开弹窗 —— 类型(功能建议/意见建议/Bug 反馈/其他)+ 内容(上限 1000 字)+ 联系方式(可选),图形验证码防刷,同一 IP 一小时内限提交 1 次
|
||
- **用户列表**:`/admin`「总览与用户」标签展示用户名/角色/状态/文件数/文件占用/设备/授权/注册/**最后登录**(relay `users.last_login`,登录与注册时写入,从未登录显示「未登录」),支持文件管理、改密、升降级、禁用/删除
|
||
- **管理后台**:`/admin` 切到「留言反馈」标签(`X-Admin-Token` 鉴权,令牌存本地 `it-tools-admin-token`),列出时间/类型/内容/联系方式/真实 IP,支持状态流转(未处理→已处理→已回复)与删除,导航标签带未处理数角标;窄屏下表格容器内横向滚动不撑破页面
|
||
- **链路**:公开页 → relay `POST /feedback`(验证码校验 + IP 限频)落盘 `data/feedback.json`;管理接口经 nginx `location /admin/` 反代到 `it-tools-relay:8091`。公网入口 https://it.88531.cn/
|
||
|
||
### 在线统计与公告推送(2026.11 新增)
|
||
|
||
- **右上角常驻**:🔔 公告铃铛(未读红点)+ `v2026.11.12` 版本徽标(源码常量 `SITE_VERSION`,与 Gitea Release tag 同步,发版时更新)
|
||
- **公告推送**:铃铛下拉面板列出授权系统公告(标题/时间/正文,未读带红条,点击已读、支持全部已读);`is_popup` 类型公告进站即弹一次(每条只弹一次,已读记录存 localStorage `it-tools-ann-read`)
|
||
- **在线统计**:打开页面即经 relay `POST /relay/hub/report` 向授权系统(auth.88531.cn 项目 6)登记安装并上报版本号(机器码复用 license 的 `getMachineId()`),每 30 分钟心跳一次;公告每 15 分钟拉取一次(`GET /relay/hub/announcements`),授权系统后台据此展示安装数/在线数/趋势
|
||
- **失败开放**:授权系统不可达时静默降级,不影响站点任何功能
|
||
- **实现注意**:公告面板与推送弹窗均 `<Teleport to="body">`——实测 top-nav 内 v-if 子树挂载会触发 Vue `insertBefore null` 崩溃;CardAuth 的 heartbeat 会清空 `client_version/device_info`,relay 侧先心跳后 check-update 保证版本号落库
|
||
|
||
### MCP 接入(2026.11 新增)
|
||
|
||
- **功能页 `/mcp-connect`**(顶栏 Plug 图标直达):连接信息、令牌管理、接入后怎么使用(三步上手 + 13 场景示例话术 + 成功自检 + 排错速查)、可调用工具清单与注意事项
|
||
- **授权即站内卡密**:与站点卡密体系同一套,购买并激活后即自动可用,无需单独开通 MCP;已授权设备打开页面直接显示主令牌,客户端配置示例自动带真实令牌(复制即用),无令牌自动创建「默认」
|
||
- **端点**:`https://<站点>/mcp`(MCP Streamable HTTP / JSON-RPC 2.0),`initialize`、`tools/list` 免鉴权,`tools/call` 必须 `Authorization: Bearer mcpt_…`
|
||
- **13 个 AI 工具**:translate_text / translate_doc / ocr / gen_image / remove_bg / upscale_image / tts / speech_to_text / extract_subtitle / video_process / convert_doc / copywriting / vision_qa(文件类入参传服务器可读绝对路径,二进制结果返回下载 URL)
|
||
- **调用记录**:Admin 左侧「MCP 调用」页(近 7 天总览 / 工具排行 / 调用流水),relay 侧 `mcp_usage` 表逐条落库
|
||
- **客户端接入**:Hermes(`config.yaml` 的 `mcp_servers`)、任意支持 HTTP 传输的 MCP 客户端、curl;配置片段在功能页 ③ 区一键复制
|
||
|
||
### AI 生图:自定义提供商 + 生成历史(2026.11 新增)
|
||
- **中文提示词自动转英文**(2026-11-13 新增):生成时检测到中文提示词,relay 自动用 LLM(mimo-v2.6-flash)转成高质量英文生图提示词再发上游(Flux/SDXL 系对英文理解最好),翻译失败回退原文绝不阻断;结果图操作行显示「🌐 已自动转英文发送(悬停查看)」,悬停可看完整英文;同词有缓存;生成历史存用户原文。
|
||
- **首页「近期新功能」清单**(2026-11-13 补齐):把最新开发完的功能(AI 生图、AI 接入 MCP、管理后台升级)加进 `Home.page.vue` 的 `NEW_FEATURES` 顶部(新→旧),★铁规则:以后每完成一批新功能必须在此清单最前面加条目,否则首页看不到。
|
||
- **生图页默认选中第一个模型**(2026-11-13 修复):打开 `/ai-gen` 页面,模型下拉与标签默认选中列表第一个(dall-e-3);原逻辑初始固定选 pollinations-flux(列表第 7 个),已改为列表加载后取 `j.data[0]` 并加空值兜底。
|
||
- **示例提示词四组分类**(2026-11-13 新增,同日四次改版定稿):「尝试这些示例」区选项卡切换——**通用(14) / 自媒体(30) / 电商(18) / 软件类(24),共 86 个**即点即填的场景提示词。第四版全组扩容 +32 词热门题材(2026-11 实时热词):通用加人形机器人/智能眼镜/芯片晶圆/脑机接口/AI陪伴玩具/情绪治愈/低碳出行/露营户外;自媒体加 AI办公智能体/Token囤货/AI导购比价/具身智能/演唱会神器/情绪价值/后屏幕交互/科普热词;电商加双12年终/虚拟试衣/国补换新/囤货清单/直播秒杀/情绪好物/年货节/跨境出海;软件类加智能体办公/大模型对话/开源生态/机器人编程/词元Token/语音助手/云同步/无代码搭建。词多时示例区出现区域内滚动条(max-height 172px 细条滚动、切组回顶,放得下则不出现)。软件类=电脑软件+手机软件合并(办公桌面、AI 概念、手持 APP、通勤办公等 16 词,覆盖软件推荐文章配图);电商=促销主图/大促 Banner/秒杀/直播带货等 10 词;自媒体=好物开箱、测评天平、拆箱瞬间等种草内容 6 词;每词带文章配图的画幅/构图/配色关键词;1024×768 与 1600×800 双断言无溢出。
|
||
|
||
- **模型来源与免费说明**:站内 10 个生图模型全部经自建 NewAPI 网关聚合——5 个 `pollinations-*` 走 Pollinations.ai(站主 API Key 预算制、对使用者免费),4 个 `flux*` + `dall-e-3` 走 Cloudflare Workers AI(站主账号免费额度,官方 10,000 Neurons/天 ≈ **173 张/天**),**对使用者全部免费但共享池有限**;模型列表由后端从网关实时拉取,下拉标注各上游配额。
|
||
- **我的提供商**:左侧「或使用自己的提供商 / API KEY」展开,填写 OpenAI 兼容接口地址 + KEY,点「连接并拉取模型」自动拉取上游模型列表;与站内模型合并展示(下拉分组「站内免费模型 / 我的模型」,自定义模型胶囊为紫色虚线框)。支持手动输入模型名回车添加、单个移除、一键清除。
|
||
- **KEY 只存本地**:接口地址与 KEY 仅保存在浏览器 localStorage(`it-tools-ai-provider`),生成时临时发给后端转发,**不入库、不落盘**(已 grep 宿主与容器数据目录验证零残留)。
|
||
- **生成历史**:每次生成成功自动落盘服务端(按机器隔离,每机上限 100 张、超限自动清理最旧),页面右侧新增 50×50 缩略图竖排历史列;点击任意缩略图回看大图,「下载图片」带 `?dl=1` 触发附件下载,「新窗口打开」直连原图,刷新后历史仍在。
|
||
- **新增端点**:`POST /relay/ai/custom-models`(测试连接并拉取模型)、`POST /relay/ai/gen-image` 扩展可选 `provider` 字段(自定义提供商转发)、`GET /relay/ai/img-history?machine=`(历史列表)、`GET /relay/ai/img/<machine>/<id>[?dl=1]`(图片文件/下载)。
|
||
- **内置免费每日次数 + 上游真实免费配额**(2026.11 新增;2026.11.13 按上游官方/实测补真实数字):「模型」区右侧实时显示、模型下拉每个选项标注上游配额、鼠标悬停显示出处——
|
||
- **机器限额**:未授权每日 **10 次**(`DAILY_FREE_LIMIT` 环境变量可调,北京时间 0 点重置,**生成成功才扣次**;自带提供商/KEY 生成不计次)。
|
||
- **上游免费池(全站共享,已授权同样受保护)**——内置模型上游是站主账号的免费额度,不存在「无限次」:
|
||
- `flux*` / `dall-e-3`(5 个)→ Cloudflare Workers AI:**官方免费 10,000 Neurons/天**,proxy 固定 1024×1024/4 步 = 57.6 Neurons/张 → **约 173 张/天**(`CF_DAILY_LIMIT` 默认 173,北京时间约 08:00 重置,账号级共享,超出 Free plan 直接报错);服务端按 `daily_gen_cf.json` 全站计数保护,池尽返回 403 并提示。
|
||
- `pollinations-*`(5 个)→ Pollinations.ai:站主 **API Key 预算制(pollen 余额)**,无固定每日张数(官方匿名档才是 45 秒/张按 IP);上游错误透传。
|
||
- **界面文案**(按所选模型联动):未授权 `免费10次·剩N · CF池剩X/173张` / `… · Pollinations按Key余额`;已授权 `已授权 · CF池剩X/173张`;CF 池尽红色 `CF免费池已用完 · 08:00重置`。
|
||
- 额度查询端点 `POST /relay/ai/quota`(带 `model` 返回 `authorized/limit/used/remaining` + `upstream/upstream_daily/upstream_used/upstream_remaining/upstream_note/cf_daily`;`remaining=-1` 表示机器维度不限,仍受共享池约束)。次数用完点「或使用自己的提供商 / API KEY」用自己的 KEY 继续生成,403 提示文案同步引导。
|
||
|
||
### AI 换脸(2026.11 新增)
|
||
|
||
- 上传源人脸照片 + 目标照片,本机 CPU 一键换脸(insightface buffalo_l 人脸检测,多脸自动取最大 + inswapper_128 换脸模型,模型 855MB 预置于镜像内)。
|
||
- 接口 `POST /relay/ai/face-swap`(multipart:`source`/`target`/`consent`),需勾选授权承诺,结果走站内 `/relay/ai/img` 图链路,支持下载。
|
||
- 授权应用:未授权用户每天可免费试用 3 次,卡密激活后不限次。
|
||
|
||
### AI 海报生成(2026.11 新增)
|
||
|
||
- 42 套热门海报模板、10 大分类(促销/节日/活动/美食/教育/校园/健身/招聘/生日/封面),模板画布 1080×1440;「校园」分类含教师节/开学第一课/家长会/秋季运动会/毕业季/社团招新/优秀学生表彰/快乐六一/考试加油/读书月等 10 款学校师生主题模板。
|
||
- 选中模板后可:**修改文字**(内容/字号/颜色/粗细/对齐/行高/斜体,预览与导出换行一致)、**旋转任意图层**(文字/图片/形状均支持,-180°~180° 滑杆 + 一键复位,预览与导出同一旋转中心)、**替换图片**(本地上传 或 AI 生成,圆角可调)、拖动移动图层、图层排序/删除、添加文字与图片框、一键切换背景渐变、AI 生成整屏背景。
|
||
- 编辑页整页自适应浏览器高度、不出现整体滚动条:内容超出时只在模板列表 / 画布 / 编辑面板各自区域内滚动(窄屏堆叠后统一为一个区域),画布始终完整可见。
|
||
- AI 配图复用 `/relay/ai/gen-image` 与每日免费生图额度,按图框宽高比自动匹配上游尺寸档位。
|
||
- 完成后一键导出 1080×1440 PNG(旋转图层同步导出)。授权应用,支持每日免费试用。
|
||
|
||
### 后台文件管理·按功能查询(2026.11 新增)
|
||
|
||
管理后台「📁 文件管理」在来源筛选旁新增**功能下拉**:按文件的 `kind`(AI 生图 / AI 换脸 / AI 海报 / 文字生图 / 标签设计 / 图片工具 / PDF 工具 / 未分类…)过滤,选项自带计数(如「AI 生图(65)」),计数随来源筛选联动;与「来源」下拉可组合使用,选择后页码自动回到第 1 页。
|
||
|
||
- 接口:`GET /admin/files?kind=<值>`,新增返回 `kinds: [{k, n}]` 分布统计(kind 过滤前统计,保证计数是当前来源下的全集);`kind=__none__` 表示未分类(无 kind 的用户根目录文件);
|
||
- 表格「类型」列同步显示中文功能名(原为 kind 英文原值);
|
||
- 仍带 `X-Admin-Token` 鉴权,无令牌 403。
|
||
|
||
### PDF 水印支持中文(2026.11 修复)
|
||
|
||
**问题**:PDF 工具「添加水印」输入中文后,生成的 PDF 里中文显示成 `???`。
|
||
|
||
**原因**:水印文字用 `embedFont('Helvetica')` 绘制——Helvetica 是 PDF 西文标准 14 字体(WinAnsi 编码),无法编码中文,pdf-lib 把超出编码范围的字符全部替换成 `?`。
|
||
|
||
**修复**(`src/tools/pdf-tools/pdf-tools.vue`):
|
||
|
||
- 新增依赖 `@cantoo/fontkit`(`@cantoo/pdf-lib` 官方推荐的 fontkit 实现);
|
||
- 中文字体 Droid Sans Fallback(4MB,覆盖 CJK,系统自带 `/usr/share/fonts/truetype/droid/`)放入 `public/fonts/DroidSansFallback.ttf`,由 nginx 直接提供;
|
||
- 水印文字含非西文字符(`charCodeAt > 0xFF`)时才按需 `fetch` 字体并 `registerFontkit` + `embedFont(bytes, { subset: true })`——子集只嵌入用到的字形,输出 PDF 增量很小(实测 3.5KB);纯英文水印仍走原 Helvetica 路径,不下载字体;
|
||
- 字节缓存在模块级变量,同一次页面会话只拉一次。
|
||
|
||
**验证**(浏览器端到端):上传测试 PDF → 中文水印「内部机密禁止外传」→ 执行 → pdfjs 提取文本层 `HAS_CN=true`、无 `???`;pdftoppm 渲染截图确认斜向水印字形正常;英文水印「CONFIDENTIAL 2026」回归通过(走 Helvetica,输出 1.6KB 无字体子集)。
|
||
|
||
### 全站编辑状态自动保存(2026.11 新增)
|
||
|
||
在任意工具页编辑时,系统会自动把当前修改状态保存到服务器:
|
||
|
||
- **每 1 分钟自动保存**,无需手动操作
|
||
- **右下角状态条常驻显示**(2026-11-15 改进):打开任何工具页立即可见,idle 态显示绿点「自动保存已开启」;编辑后变 `未保存`,自动/手动保存后显示 `已保存 HH:MM`;恢复草稿时显示 `已恢复当前功能草稿 HH:MM · 体积`——**该提示常驻到你开始编辑**(不再几秒自动消失),随时可操作
|
||
- **「立即保存」按钮全程可点**(保存中除外):idle 态点一下即保存当前内容
|
||
- **离开拦截**:未保存就刷新、关闭、站内前进后退时提示「当前内容还没保存,离开会丢失」——点「确定」= 先保存再离开,点「取消」= 留在本页
|
||
- **刷新自动恢复**:重新进入工具页自动还原上次未保存的内容
|
||
- **找回历史版本**(2026-11-15 新增):状态条上的「找回」按钮列出该工具的保存历史(服务端留档 20 份,时间精确到秒),点任意一条立即把页面内容恢复成那一版,随后可继续编辑;内容没有变化的重复保存只更新时间,不会重复占档。面板顶部标明「当前功能:<工具名>」——草稿按工具隔离,只显示本工具的记录;历史首项若就是服务端当前草稿会标绿色「当前草稿」徽标
|
||
- **丢弃草稿**(2026-11-15 新增):恢复提示旁的「丢弃草稿」按钮删除服务端保存的这份草稿(当前页面内容与历史留档都不受影响),之后刷新不再自动恢复;想找回还能从历史列表里点回来
|
||
|
||
> 实现:通用 DOM 快照一次性覆盖全部工具(无需逐个改造),字段定位用 `name > tag:type:组内序号`(框架动态 id 每次刷新都会变,实测不能用);服务端四端点 `/draft/save|load|history|delete`,按机器码隔离。
|
||
|
||
### 历史记录 100 条上限(2026.11 新增)
|
||
|
||
所有功能里的历史记录最多显示 100 条(按时间倒序取最新 100 条):
|
||
|
||
- 服务端 `GET /relay/ai/img-history` 与 `GET /admin/mcp-usage` 调用流水统一截断前 100 条(只影响展示条数,后台总记录数/总调用量统计不受影响);
|
||
- 前端图片历史共享层(`loadImgHist`)、AI 生图与海报生成的自建历史均带 100 条本地兜底;
|
||
- 已有上限低于 100 的(生成记录 50 条、网速测速 20 条等)保持原值。
|
||
|
||
### 后台文件管理(2026.11 新增)
|
||
|
||
管理后台「文件管理」页全面升级:
|
||
|
||
- **默认全量视图**:进入即显示**所有用户**上传的文件 + AI 生成图片(换脸/生图/海报/编辑)+ MCP 产出文件的聚合列表,无需先选用户;下拉仍可按「仅 AI 生成 / 仅某用户」过滤。
|
||
- **50 条/页自动分页**:超过 50 条自动分页,页头页尾都有翻页控件,**显示总记录数与总大小**(如「共 81 条记录 · 合计 31.5 MB」)。
|
||
- **图片 100×100 缩略图**:图片类型文件在「预览」列显示 100×100 缩略图,点击看原图;**其他文件显示文件类型徽标**(PDF/PNG/MP4…)。
|
||
- **单独下载**:每一行都有「下载」链接(`Content-Disposition: attachment` 带原文件名),与「删除」并列;删除按来源分流(用户文件走 files 表、AI 生成图同步删 index、MCP 文件防路径穿越)。
|
||
- **安全**:缩略图与下载走统一 `/relay/admin/file?path=…&token=…` 路由(`<img>`/`<a>` 无法携带 header,鉴权走 query token,与 header 双通道校验);路径白名单限定 `users/`、`gen_images/`、`mcp_files/` 三棵子树 + realpath 校验,防目录穿越;无 token 请求 403。
|
||
- 服务端按 mtime 全局排序后切片分页,每项附带 `source`(user/gen/mcp)、`file_type`、`is_image`、相对 `path` 字段。
|
||
|
||
## 优势
|
||
|
||
- **一次激活,全站通用**:输入一次卡密,全部授权功能解锁,无需逐个购买
|
||
- **先用后买**:每个授权功能每天免费试用 30 分钟,觉得好用再付费
|
||
- **隐私友好**:PDF/图片/OCR 工具全程浏览器本地处理,文件不上传服务器
|
||
- **自建服务稳定**:翻译、OCR、AI 修图、文档转换均为自建服务,不依赖第三方接口
|
||
- **永久套餐**:买断制授权,不按次、不按月
|
||
- **免费工具持续更新**:20+ 基础工具永久免费,新工具不断增加
|
||
|
||
## 部署(Docker,三条命令跑起来)
|
||
|
||
### 第一步:构建前端镜像
|
||
|
||
需要装好 [Docker](https://docs.docker.com/engine/install/) 和 [Node.js 18+](https://nodejs.org/)(Node 只在构建时用,装完可以卸载)。Windows/Mac 装 Docker Desktop 就自带一切。
|
||
|
||
```sh
|
||
git clone https://github.com/personal82555/it-tools-pro.git
|
||
cd it-tools-pro
|
||
pnpm install # 没装 pnpm 的话先执行:npm i -g pnpm
|
||
pnpm build
|
||
docker build -t it-tools:custom .
|
||
```
|
||
|
||
### 第二步:启动工具站
|
||
|
||
```sh
|
||
docker network create ittools-net
|
||
docker run -d --name it-tools --restart always --network ittools-net -p 8080:80 it-tools:custom
|
||
```
|
||
|
||
打开浏览器访问 `http://服务器IP:8080` —— **20+ 免费工具已全部可用**(条码、二维码、JSON、PDF、图片工具、网站收藏等,PDF/图片处理全在浏览器本地完成,无需任何后端)。
|
||
|
||
### 第三步(可选):启动授权/翻译/格式转换后端
|
||
|
||
需要在线翻译、OCR、AI 修图、文档转换等功能时再启动(依赖自建的 CardAuth 授权服务):
|
||
|
||
```sh
|
||
# 1) 先启动 relay(授权/翻译/格式转换后端)
|
||
cd docker/it-tools-relay
|
||
cp .env.example .env # 编辑 .env 填入你的 CardAuth 地址和密钥
|
||
docker build -t it-tools-relay .
|
||
docker run -d --name it-tools-relay --restart always --network ittools-net \
|
||
-p 8091:8091 --env-file .env -v relay-data:/app/data it-tools-relay
|
||
|
||
# 2) relay 就绪后重启工具站(nginx 需能按容器名 it-tools-relay 访问它)
|
||
docker rm -f it-tools
|
||
docker run -d --name it-tools --restart always --network ittools-net -p 8080:80 it-tools:custom
|
||
```
|
||
|
||
**不启动第三步也完全能用**,只是翻译/OCR/格式转换这几个高级功能会显示试用/授权提示,免费工具不受任何影响。
|
||
> 注意:relay 与工具站必须在同一 Docker 网络(ittools-net),且先启动 relay 再启动工具站。
|
||
|
||
### 方式二:Docker Compose部署
|
||
|
||
上面三步 `docker run` 的等价编排(含全部参数)。前置要求不变:先 `pnpm install && pnpm build` 生成 `dist/`;`docker/it-tools-relay` 的 Dockerfile 需要 `hf-cache/`、`piper-models/`、`ai-models/`、`waifu2x/` 四个模型目录(未入库),没有的话把 relay 的 `build:` 换成现成镜像 `image: 192.168.68.19:3200/jinghui/it-tools-relay:latest`。
|
||
|
||
```yaml
|
||
services:
|
||
it-tools-relay:
|
||
build: ./docker/it-tools-relay
|
||
image: it-tools-relay:latest
|
||
container_name: it-tools-relay
|
||
restart: always
|
||
ports:
|
||
- "8091:8091"
|
||
env_file:
|
||
- ./docker/it-tools-relay/.env
|
||
volumes:
|
||
- relay-data:/app/data
|
||
networks:
|
||
- ittools-net
|
||
|
||
it-tools:
|
||
build: .
|
||
image: it-tools:custom
|
||
container_name: it-tools
|
||
restart: always
|
||
depends_on:
|
||
- it-tools-relay
|
||
ports:
|
||
- "8080:80"
|
||
extra_hosts:
|
||
# nginx 反代宿主机上的 rapidocr(5000) / iopaint(8060) 需要
|
||
- "host.docker.internal:host-gateway"
|
||
networks:
|
||
- ittools-net
|
||
|
||
# 可选:本地 OCR 加速(不部署则图片OCR/PDF文字识别不可用)
|
||
# rapidocr:
|
||
# image: rapidocr/rapidocr:latest
|
||
# container_name: rapidocr
|
||
# restart: always
|
||
# ports:
|
||
# - "5000:5000"
|
||
#
|
||
# 可选:AI 修图(去水印/抠图/超分/人脸修复)
|
||
# iopaint:
|
||
# image: sanster/iopaint:latest
|
||
# container_name: iopaint
|
||
# restart: always
|
||
# ports:
|
||
# - "8060:8060"
|
||
# volumes:
|
||
# - iopaint-models:/root/.cache
|
||
|
||
volumes:
|
||
relay-data:
|
||
# iopaint-models:
|
||
|
||
networks:
|
||
ittools-net:
|
||
driver: bridge
|
||
```
|
||
|
||
```bash
|
||
git clone http://192.168.68.19:3200/jinghui/it-tools-pro.git
|
||
cd it-tools-pro
|
||
pnpm install && pnpm build # 生成 dist/(Dockerfile 不做前端构建)
|
||
cd docker/it-tools-relay && cp .env.example .env && cd ../.. # 填 CardAuth 地址与密钥
|
||
docker compose up -d --build
|
||
```
|
||
|
||
打开 `http://服务器IP:8080`。只起工具站、不要 relay 时用 `docker compose up -d it-tools`(翻译/OCR/格式转换会显示试用提示,免费工具不受影响)。
|
||
|
||
### 可选:本地 OCR / AI 修图模型后端
|
||
|
||
| 服务 | 端口 | 用途 |
|
||
|---|---|---|
|
||
| [rapidocr](https://github.com/RapidAI/RapidOCR) | 5000 | 图片OCR / PDF 文字识别加速 |
|
||
| [iopaint](https://github.com/Sanster/iopaint) | 8060 | AI 修图(去水印/抠图/超分/人脸修复) |
|
||
|
||
未部署时对应功能不可用,其余功能不受影响。
|
||
|
||
### 授权体系(进阶)
|
||
|
||
授权校验三层生效:前端 LicenseGate(试用计时浮条)→ nginx auth_request(服务端强制)→ relay /check(CardAuth 实时查询,fail-open 不锁死已付费用户)。受控功能清单见 `src/tools/license/license.ts` 与 `docker/it-tools-relay/server.py` 的 `PROTECTED_TOOLS`。
|
||
|
||
## 开发
|
||
|
||
```sh
|
||
pnpm install # 安装依赖
|
||
pnpm dev # 开发服务器(热更新)
|
||
pnpm build # 类型检查 + 生产构建
|
||
pnpm test # 单元测试(Vitest)
|
||
pnpm run script:create:tool my-tool-name # 新工具脚手架
|
||
```
|
||
|
||
推荐 VSCode + Volar 插件开发。
|
||
|
||
## 致谢与许可
|
||
|
||
本项目基于 [CorentinTh/it-tools](https://github.com/CorentinTh/it-tools)(GNU GPLv3 License)开发,感谢原作者 [Corentin Thomasset](https://corentin.tech) 的开源贡献。本项目遵循 GPLv3 开源许可。
|