静态部署
静态托管
如果国内静态资源库没有你要的静态包，推荐用 npm i 命令将静态包下载到本地，并部署到阿里云/七牛云的国内服务器上，避免网页受 UNPKG 和 jsDelivr 屏蔽影响而出现偏差。
静态资源库：
- 字节 CDN：国内测速表现最佳，缓存过期时间最长设置一年。
- Staticfile CDN：CDN 加速由七牛云提供。
NPM 包
- UNPKG：有墙风险且不稳定，默认为最新版本，无需
@latest标签。- 将静态文件发布为 npm 包，参考 一分钟教你发布 npm 包。
- 加速：在 npm 官方源 中搜索包位置，然后使用前缀
https://unpkg.com/。
- UNPKG 镜像：有资源可以用服务器自建服务，反向代理 unpkg。
- NPM MIRROR：NPM 项目的国内镜像镜像，不能做静态托管用途。
https://registry.npmmirror.com/项目名/版本号可以看见项目的各种信息，但看不了里面的文件。 jsDelivr（已墙）：速度最快，原本是最稳的，但域名暴雷后，经常断开，2022.06.01 彻底打不开。配合 Github action，更新后自动访问 jsdelivr CDN 缓存刷新链接，保持页面常新。刷新命令参考curl https://purge.jsdelivr.net/gh/username/project/file。饿了么 CDN（已关）：国内唯一能用的 npm 镜像，2022.07.13 发现外部访问被拒绝。之前饿了么并没说支持对外，可能已经彻底取消了。使用饿了么 CDN 时，注意https://npm.elemecdn.com/react@latest/需要时间更新，具体频率未知，可固定大版本号来获取更新https://npm.elemecdn.com/react@^18/。
部署平台
- Cloudflare：Pages 和 Workers 两类部署方式。
- Workers：复制镜像网站，可直接访问，但反向代理稳定性成疑。
- Pages：部署简单，外网速度很快，但国内速度不稳，而且 page.dev 域名有时会被墙，可购买便宜的临时域名（一年）来解决该问题。
- Netlify：国内速度慢点，图片容易卡死，但还算稳定。
- Vercel：推荐使用 GitHub 账户登录，有可能需要绑定国外手机号（不支持 Voice）。2022.08.26，「*.vercel.app」域名被 DNS 污染，需要绑定自定义域名。
- AWS: 邮箱注册，不过需要信用卡认证。
- 国内平台：Gitee、WuliHub、CODING，都需要实名认证。
IPFS
IPFS 无需服务器就可建立静态网站，号称永不失效，但国内稳定性成疑问，实用性一般。IPFS 托管在一个网关上，并不会自动复制到所有网关。
pinata 上传网站构建的目录文件夹，上传后，即可通过 IPFS Hash 访问。网站目录中必须有 index.html，否则网页中将显示网站目录。即使有 index.html，其他人在拥有 CID 后，可以通过 IPFS Desktop 来获取网站的完整目录。为确保私密性，建议只上传单文件。使用单文件 CID 视为单一网站，不可调用原目录中的文件。[1]
上传 ipfs 到 pinata 之后，cloudflare 等其他网关不一定会完全复制文件，php 无法抓取加载，所以不建议使用 cloudflare 网关。
cloudflare 接管 pinata 后，ipfs 域名需通过「pinata 托管 - cloudflare DNS - cloudflare SSL」。如果中途将 DNS 指向 http://gateway.pinata.cloud 等非 cloudflare ipfs 网关域名，cloudflare SSL 证书将失效。即便把链接改为非加密的 http，pinata 依然会视之为无效链接而拒绝访问。
对于文件较少且链接有效的域名，可按 Cloudflare IPFS 页面说明来设置 DNS，提交 IPFS 域名 30 分钟后，即可获取 SSL 证书。
- 添加 CNAME 记录，将你的 IPFS 域名 (xxx.example.com) 指向
cloudflare-ipfs.com。 _dnslink.xxx.example.com设置为dnslink=/ipfs/<your_ipfs_hash_here>。
GitHub 同步到 VPS
代码、文章推送到 GitHub 后，会自动生成可访问的网页，但国内访问 GitHub Pages 的速度极不稳定，为了确保网站能被正常访问，必须增加国内的访问节点。
很多人选择 Gitee Pages 作为国内节点，GitHub Actions 将新文档同步到 Gitee，生成位于国内的静态页面 Gitee Pages。但是，Gitee Pages 的限制非常多，免费版无法自定义域名，必须实名验证，更别提近期的下架风波。因此，我没选 Gitee，而是把文档同步到国内服务器（域名需备案）。
!> 注意：文件夹不要有大写字母，否则同步时容易出错。
同步到 FTP
如果你有 FTP 服务器，可使用 FTP-Deploy-Action 将 github 代码推送到服务器上。Actions 步骤参考 GitHub 说明。
on: push
name: 🚀 Deploy website on push
jobs:
web-deploy:
name: 🎉 Deploy
runs-on: ubuntu-latest
steps:
- name: 🚚 Get latest code
uses: actions/checkout@v3
- name: 📂 Sync files
uses: SamKirkland/FTP-Deploy-Action@4.3.0
with:
server: ${{ secrets.ftp_host }}
username: ${{ secrets.ftp_username }}
password: ${{ secrets.ftp_password }}
port: ${{ secrets.ftp_port }} # 建议更改默认的 21 端口
新建 FTP 时，需在云服务商的安全组和服务器上开放 FTP 端口，并临时暂停宝塔系统加固等安全插件（新建 FTP 容易与安全插件冲突）。
如果出现 FTPError: 530 Login authentication failed，则说明 FTP 密码错误或账号不存在，需用 FileZilla 测试 FTP 的有效性。确认 FTP 无效后，检查 FTP 密码是否填写正确，是否只有大小写字母和数字。如果密码错误，则在 github secrets 重新 update 密钥。如果密码正确，则进入 /www/server/pure-ftpd/etc/pureftpd.passwd，检查是否有该 FTP 账户。没有 FTP 账户的话，暂停宝塔系统加固等安全插件后，重新新建 FTP。
如果出现 Error: Timeout (control socket)，则说明同步服务器超时，可进入 Actions 页面点击右侧按钮「Re-run all jobs」，重新进行部署。如果错误连续出现，可以尝试关闭防火墙，测试是否 GitHub 服务器被拉黑了。
同步到 oss
如果没有服务器，可以把文件部署在云运营商的云存储上。比如用 aliyun-oss-website-action，将 repo 文件 build 成网站文件，然后同步到阿里云 oss 并运行网站。
name: deploy md to oss
on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]
jobs:
build:
runs-on: ubuntu-latest
steps:
# load repo to /github/workspace
- uses: actions/checkout@v3
- name: Use Node.js
uses: actions/setup-node@v3
with:
node-version: '14.x'
# 打包文档命令
# - run: npm install yarn@1.22.4 -g
# - run: yarn install
# - run: yarn docs:build #需要配合 yarn 的 package.json
- name: aliyun-oss-website-action
uses: fangbinwei/aliyun-oss-website-action@v1.3.0
with:
accessKeyId: ${{ secrets.ACCESS_KEY_ID }}
accessKeySecret: ${{ secrets.ACCESS_KEY_SECRET }}
bucket: learndata-notes
# use your own endpoint
endpoint: oss-cn-shanghai.aliyuncs.com
# 全目录上传
folder: .
# 不上传的文件
exclude: |
.github/
.gitattributes