pdftool.work 是一个纯静态、多语言、全客户端处理的在线 PDF 工具站。站点使用 Tailwind CSS、pdf-lib 和 PDF.js，PDF 文件只在用户浏览器中读取和处理，不上传到本站服务器。生产构建覆盖简体中文、英语、西班牙语、巴西葡萄牙语、日语和印尼语，并将每种语言输出到互相隔离的 URL 路径。
- index.html：首页、工具导航、优势说明和 FAQ。
- upload-ready.html：将单个 PDF 压到 200KB、500KB、1MB 或自定义上限，验证实际大小。
- merge.html：多文件 PDF 合并、排序、进度和下载。
- split.html：按页码范围或逐页分割 PDF。
- manage.html：删除、旋转和拖拽排序 PDF 页面。
- compress.html：安全的 PDF 结构优化，不主动降低图片清晰度。
- pdf-to-jpg.html：将 PDF 每一页转换为高清 JPG 图片。
- jpg-to-pdf.html：将 JPG、PNG 等图片批量合并为一个 PDF 文件。
- pdf-rotate.html：批量旋转 PDF 每一页的角度（90°/180°/270°）。
- pdf-unlock.html：移除 PDF 打开密码，生成无密码版本。
- blog.html：PDF 教程博客聚合页。
- blog-merge-pdf.html：如何免费合并 PDF 教程。
- blog-pdf-tips.html：PDF 压缩太大怎么办。
- blog-jpg-to-pdf.html：JPG 图片转 PDF 教程。
- compress-pdf-to-200kb.html：PDF 压缩到 200KB 专用落地页
- compress-pdf-to-500kb.html：PDF 压缩到 500KB 专用落地页
- compress-pdf-to-1mb.html：PDF 压缩到 1MB 专用落地页
- compress-pdf-for-visa.html：签证申请材料 PDF 压缩
- compress-pdf-for-exam-registration.html：考试报名材料 PDF 压缩
- compress-pdf-for-application.html：申请材料 PDF 压缩
- compress-pdf-for-enterprise.html：企业用户 PDF 压缩
- compress-pdf-id-card.html：证件 PDF 压缩
- compress-pdf-pay-slip.html：工资条 PDF 压缩
- compress-scanned-pdf.html：扫描件 PDF 压缩
- pdf-too-large-to-upload.html：文件过大处理指南
- resize-pdf-for-upload.html：调整 PDF 上传尺寸
- pdf-contract-too-large.html：合同 PDF 过大处理
- pdf-thesis-large.html：论文 PDF 过大处理
- pdf-receipt-too-large.html：收据 PDF 过大处理
- pdf-tutorial-for-students.html：学生 PDF 教程
- services.html：PDF 批量处理与企业内网部署服务。
- about.html：产品定位与运营说明。
- privacy.html：文件本地处理、Cookie、广告和日志政策。
- sitemap.xml、robots.txt：搜索引擎抓取入口。
- ads.txt：AdSense 授权销售商记录。
pdftool.work/
├─ .github/
│ └─ workflows/
│ └─ test.yml
├─ index.html
├─ upload-ready.html
├─ merge.html
├─ split.html
├─ manage.html
├─ compress.html
├─ about.html
├─ privacy.html
├─ sitemap.xml
├─ robots.txt
├─ ads.txt
├─ assets/
│ ├─ css/
│ │ ├─ tailwind.min.css
│ │ └─ styles.css
│ ├─ js/
│ │ ├─ site.js
│ │ ├─ merge.js
│ │ ├─ split.js
│ │ ├─ manage.js
│ │ ├─ compress.js
│ │ ├─ upload-ready.js
│ │ ├─ upload-ready-worker.mjs
│ │ └─ pdf-preview.js
│ └─ vendor/
│ ├─ pdf-lib.min.js
│ ├─ pdf-lib.esm.min.js
│ └─ pdfjs/
├─ site/
│ ├─ config/ # 语言、路由和运行时键注册表
│ ├─ content/ # 六种语言的结构化页面内容
│ ├─ lib/ # 内容校验、路径、SEO 和 sitemap 生成
│ └─ templates/ # 共享布局、工具页和落地页模板
├─ src/
│ └─ tailwind.css
├─ scripts/
│ ├─ build-site.mjs # 原子生成并校验 dist/
│ ├─ copy-vendor.mjs
│ └─ verify-release.mjs
├─ dist/ # npm run build 生成，不直接手改
├─ deploy/
│ ├─ deploy.ps1
│ ├─ preflight.ps1
│ └─ nginx/
│ └─ pdftool.work
├─ tests/
│ ├─ helpers/
│ │ └─ page.js
│ ├─ pdf-tools.test.js
│ └─ site.test.js
├─ CHANGELOG.md
├─ CLAUDE.md
├─ package.json
├─ package-lock.json
├─ TESTING.md
├─ TODOS.md
├─ VERSION
├─ tailwind.config.js
└─ vitest.config.js
服务器采用版本目录和 current 软链接：
/var/www/pdftool.work/
├─ current -> /var/www/pdftool.work/releases/20260629153000
└─ releases/
├─ 20260629153000/
└─ 其他历史版本/
Nginx 配置文件最终路径为：
/etc/nginx/sites-available/pdftool.work
- Node.js 24（CI 使用的版本）
- npm
- Python 3，用于启动简单静态服务器
npm ci
npm run build
npm testnpm run build 会执行以下步骤：
- 扫描 HTML、模板和浏览器脚本，生成压缩后的
assets/css/tailwind.min.css。 - 从
site/content/和site/templates/生成 98 条多语言路由，并保留获准发布的既有静态页面。 - 复制锁定的 pdf-lib 1.17.1 与 pdfjs-dist 6.1.200，包括 PDF.js 模块、Worker、CMap、标准字体、WASM 解码器和 ICC 配置。
- 在临时目录生成 canonical、hreflang、sitemap 和带文件哈希的
release-manifest.json，通过发布校验后原子替换dist/。
npm test 会先重新生成 dist/，再运行 Vitest 单元测试，并在 Chromium 与 Microsoft Edge 中验证真实 Worker、Canvas、语言隔离、隐私隔离、缩略图和完整工具流程。测试夹具、分层与编写约定见 TESTING.md。
npm run serve浏览器访问 http://localhost:8080/。修改 Tailwind 类名时可另开终端运行：
npm run watch:css不要直接双击 file:// 页面做最终测试。HTTP 服务器更接近生产环境，也能更准确地暴露资源路径问题。
服务器地址：154.217.241.238
生产域名：https://pdftool.work
在本地项目根目录执行：
powershell -ExecutionPolicy Bypass -File .\deploy\preflight.ps1预检会检查生产静态文件、根域与 www 的 A 记录，以及 VPS 的 22、80、443 端口。它还会发送只读 Host 请求，判断 pdftool.work 的 Nginx 虚拟主机是否已经安装，不会修改本地或远程配置。
只有 PREFLIGHT_OK 表示必需条件已满足。Nginx host route 是提示项，可在首次安装站点配置前显示失败。
在域名服务商添加：
| 类型 | 主机记录 | 值 |
|---|---|---|
| A | @ | 154.217.241.238 |
| A | www | 154.217.241.238 |
如果存在指向其他服务器的 AAAA 记录，请更新或删除。申请证书前，确认两个域名都已经解析到该 VPS。
Windows 检查命令：
Resolve-DnsName pdftool.work
Resolve-DnsName www.pdftool.workssh root@154.217.241.238
sudo apt update
sudo apt install -y nginx snapd
sudo mkdir -p /var/www/pdftool.work/releases
sudo systemctl enable --now nginx如果服务器启用了 UFW，再放行 SSH、HTTP 和 HTTPS：
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw status不要在未确认 SSH 已放行时直接启用 UFW，以免锁住远程连接。
在本地项目根目录运行：
scp .\deploy\nginx\pdftool.work root@154.217.241.238:/etc/nginx/sites-available/pdftool.work
ssh root@154.217.241.238 "ln -sfn /etc/nginx/sites-available/pdftool.work /etc/nginx/sites-enabled/pdftool.work && nginx -t && systemctl reload nginx"配置包含：
- www 到主域的 301 跳转
- 静态文件 404 处理，不错误回退到首页
- gzip 压缩
- 7 天静态资源缓存
- HTML、robots.txt、sitemap.xml 和 ads.txt 禁止长期缓存
- nosniff、SAMEORIGIN、Referrer-Policy 和 Permissions-Policy 安全响应头
首次部署前 current 目录尚不存在时，Nginx 会暂时返回 404，属于正常现象。
部署脚本会先执行 npm ci、生产构建、单元测试和 Chromium/Edge 浏览器测试，再上传新版本并原子切换 current 软链接。激活后会检查页面、模块、Worker、CMap、字体和 WASM；失败会自动恢复上一个版本：
powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1 -HealthUrl "http://pdftool.work/"使用 SSH 私钥：
powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1 -IdentityFile "$HOME\.ssh\id_ed25519" -HealthUrl "http://pdftool.work/"SSL 配置完成后，后续直接运行：
powershell -ExecutionPolicy Bypass -File .\deploy\deploy.ps1可用参数：
- -User：SSH 用户，默认 root。
- -Server：服务器 IP，默认 154.217.241.238。
- -IdentityFile：SSH 私钥路径。
- -SkipBuild：只跳过 npm ci 与生产构建，不能跳过测试。
- -EmergencySkipTests：紧急跳过测试，会打印醒目警告，不应作为常规发布参数。
- -SkipHealthCheck：紧急跳过发布后完整烟测，不应作为常规发布参数。
脚本只上传经过 manifest 哈希校验的 dist/ 静态成品，不上传 node_modules、src、site、scripts、package.json 或部署配置。
先保证 HTTP 页面可以通过公网访问，且 80、443 端口已放行。Certbot 官方当前推荐通过 Snap 安装：Certbot Nginx 官方说明。
在 VPS 执行：
sudo snap install core
sudo snap refresh core
sudo snap install --classic certbot
sudo ln -sf /snap/bin/certbot /usr/local/bin/certbot
sudo certbot --nginx \
-d pdftool.work \
-d www.pdftool.work \
--redirect \
--agree-tos \
--no-eff-email \
--email YOUR_REAL_EMAIL
sudo certbot renew --dry-run必须把 YOUR_REAL_EMAIL 替换为真实可收件邮箱。如果 www 尚未解析到服务器，应先补 DNS，不要直接申请包含 www 的证书。
验证：
curl -I https://pdftool.work/
curl -I https://www.pdftool.work/
systemctl list-timers | grep certbotwww 应最终跳转到 https://pdftool.work/。
部署脚本保留历史 releases。查看版本：
ls -1 /var/www/pdftool.work/releases
readlink -f /var/www/pdftool.work/current切换到指定历史版本：
sudo ln -sfn /var/www/pdftool.work/releases/目标版本 /var/www/pdftool.work/current.next
sudo mv -Tf /var/www/pdftool.work/current.next /var/www/pdftool.work/current
sudo nginx -t
sudo systemctl reload nginx当前 dist/ 发布物中的 AdSense 页面已统一启用发布商 ca-pub-2913395948188969 和响应式广告位 6363231932，ads.txt 也已发布对应授权记录。广告是否实际展示仍取决于 AdSense 后台审核、站点状态、流量质量和地区同意要求。
上线前按以下顺序核对：
-
在 AdSense 后台确认
pdftool.work已归属当前发布商并通过站点审核。 -
确认响应式广告位
6363231932仍处于有效状态；变更广告位时应同步更新全部页面并运行测试。 -
确认
ads.txt中的发布商 ID 与 AdSense 后台完全一致：google.com, pub-2913395948188969, DIRECT, f08c47fec0942fa0 -
确认 https://pdftool.work/ads.txt 返回 HTTP 200。
-
创建或转发 privacy@pdftool.work，确保隐私页面中的联系方式真实可用。
-
根据访客地区配置 Google 认证的同意管理平台。面向欧洲经济区、英国和瑞士展示广告时尤其需要检查 CMP 要求。
-
不要自行点击广告，不要诱导点击，也不要把广告伪装成下载按钮或工具操作按钮。
广告位已经在代码中用注释标出：
- 顶部横幅
- 工具操作区下方
- 处理结果区域
styles.css 和 site.js 中的 XXXXXXXXXXXXXXXX 是占位配置的防护逻辑，用于在 ID 被清空时自动隐藏广告容器，不需要替换。
npm ci
npm run build上线后逐项确认：
- 六种语言的首页、核心工具页和五个增长语言的落地页返回 HTTP 200，语言切换不会串到其他语言的导航或运行时文本。
- PDF.js 模块、Worker、CMap、字体、WASM 和 ICC 代表资源返回正确 MIME 类型。
- www 正确 301 到主域。
- sitemap.xml、robots.txt 和 ads.txt 可访问。
- 浏览器控制台没有资源 404 或 JavaScript 错误。
- 四个 PDF 工具均可生成并下载结果。
- 手机宽度下没有横向滚动。
- privacy@pdftool.work 可以正常收件。
- AdSense 广告容器可见，浏览器控制台没有重复初始化或广告脚本错误。
PDF 内容不会经过 Nginx 上传。Nginx 只提供 HTML、CSS、JavaScript 和 vendor 静态文件，并记录普通访问日志。浏览器的可处理文件大小取决于用户设备内存，因此 client_max_body_size 对这些工具没有作用。
当前 Nginx 配置未启用 CSP 和 HSTS。原因是 AdSense 域名清单需要在真实广告启用后验证，HSTS 也应在 HTTPS 稳定运行后再添加，避免过早锁定错误配置。
材料上传助手首版仅支持桌面 Chrome 与 Microsoft Edge；触屏优先设备会显示兼容提示并保留基础工具入口。工具只验证所选文件大小上限，不承诺具体门户接受文件。