PicX 搭建教程 – 基于 GitHub 的零成本图床，永久免费

一、PicX 是什么

PicX 是一个基于 GitHub 的免费图床工具。它不需要你购买服务器、不需要配置数据库、不需要安装任何运行环境——你只需要有一个 GitHub 账号，就能在 5 分钟内搭建好一个属于自己的图床。

它的工作原理非常巧妙：

1. 你在 PicX 网页中上传图片。
2. PicX 把图片自动提交到你指定的 GitHub 仓库中。
3. 图片通过 GitHub 的 CDN（jsDelivr 或 GitHub Pages）生成一个稳定的直链。
4. 你把这个直链用在博客、论坛、Markdown 文档中即可。

PicX 的核心特点：

• 完全免费：GitHub 仓库免费无限公共存储，不需要服务器。
• 稳定可靠：图片托管在 GitHub 上，比用微博图床等第三方服务稳定得多。
• 零部署：不需要安装任何东西，浏览器打开 PicX 网站直接使用。
• CDN 加速：自动通过 jsDelivr CDN 生成图片链接，国内访问速度不错。
• 图片管理：在 PicX 中可以查看、删除、复制已上传的图片。
• 完全开源：GitHub 仓库：https://github.com/XPoet/picx

二、你需要准备什么

准备项	说明
一个 GitHub 账号	如果没有，去 https://github.com 免费注册一个
一个 GitHub 仓库	用来存放上传的图片
一个 GitHub Token	用于 PicX 获得写入你仓库的权限
浏览器	Chrome、Edge、Firefox 均可

三、Step 1：注册 GitHub 账号

如果你已经有 GitHub 账号，跳过这一步。

1. 打开浏览器，访问 https://github.com
2. 点击右上角的 Sign up（注册）。
3. 输入你的邮箱、密码、用户名。用户名建议用英文，比如 zhangsan 或 myblog。
4. 完成人机验证，点击 Create account。
5. GitHub 会发一封验证邮件到你的邮箱，打开邮箱，输入验证码。
6. 注册完成，登录 GitHub。

四、Step 2：创建一个图片仓库

1. 登录 GitHub 后，点击右上角的 + 号 → New repository（新建仓库）。
2. 填写仓库信息：
   • Repository name（仓库名称）：填写 picx-images 或 my-images（你可以随便起名，英文即可）。
   • Description（描述）：可选，写“我的图床图片仓库”。
   • 仓库类型：选择 Public（公开）。必须选择公开，否则图片链接无法被外部访问。
3. 不要勾选“Add a README file”（我们不需要自动生成文件）。
4. 点击 Create repository（创建仓库）。

仓库创建好了。现在它是一个空仓库，接下来我们需要一个 Token 来授权 PicX 写入这个仓库。

五、Step 3：创建 GitHub Token（授权密钥）

Token 是一个密钥，用来让 PicX 获得写入你仓库的权限。就像你把家门钥匙给了 PicX，它才能帮你把图片放进仓库里。

1. 在 GitHub 任意页面，点击右上角你的头像 → Settings（设置）。
2. 在左侧菜单最底部，点击 Developer settings（开发者设置）。
3. 点击 Personal access tokens（个人访问令牌） → Tokens (classic)。
4. 点击 Generate new token（生成新令牌） → 选择 Generate new token (classic)。
5. 填写：
   • Note（备注）：写 picx（帮助你记住这个 Token 是给谁用的）。
   • Expiration（过期时间）：选择 No expiration（永不过期），否则过期后图床会失效。
   • 权限勾选：只勾选 repo 这个大类（勾选 repo 会自动勾选它下面的所有子项）。这个权限允许 PicX 读取和写入你的仓库。
6. 滚动到页面底部，点击 Generate token。
7. 页面会显示一串类似 ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 的字符串。立刻点击旁边的复制按钮，复制并保存到记事本中。这个 Token 只会显示这一次，关闭页面后就再也看不到了。

六、Step 4：配置 PicX

现在去 PicX 网站，用刚才创建的仓库和 Token 来配置图床。

1. 打开浏览器新标签页，访问 PicX 的在线版本：https://picx.xpoet.cn
2. 首次使用会弹出配置窗口。如果没有弹出，点击页面上的 设置 按钮。
3. 填写以下信息：
   • Owner（仓库所有者）：填写你的 GitHub 用户名。例如 zhangsan。
   • Repo（仓库名称）：填写你刚才创建的仓库名称。例如 picx-images。
   • Branch（分支）：填写 main（GitHub 默认分支名，如果你用的是旧版 GitHub 可能是 master，不确定的话去仓库页面看看左上角显示的分支名）。
   • Token：粘贴刚才复制的 GitHub Token。
   • 存储目录：可以填 images/ 或留空。如果填了 images/，上传的图片会存在仓库的 images 文件夹下。
4. 点击 确认。

配置完成！现在你可以开始上传图片了。

七、Step 5：上传图片并获取链接

1. 在 PicX 主页，点击 上传 区域，或者直接把图片文件拖拽到页面上。
2. 支持批量上传，一次可以选择多张图片。
3. 上传完成后，图片会出现在下方的列表中。
4. 点击图片下方的 复制 按钮，PicX 会自动生成多种格式的链接：
   • URL：原始直链，适合在网页中引用。
   • HTML：<img src="..."> 格式，适合在 HTML 代码中直接粘贴。
   • Markdown：![](url) 格式，适合在 Markdown 文档中插入。
   • BBCode：[img]url[/img] 格式，适合在论坛中使用。
5. 选择你需要的格式，复制链接，粘贴到你要使用的地方。

八、PicX 的图片链接原理

你上传的图片存储在 GitHub 仓库中。PicX 默认通过 jsDelivr CDN 来生成图片链接，格式为：

https://cdn.jsdelivr.net/gh/你的用户名/仓库名@分支名/文件路径

例如：

https://cdn.jsdelivr.net/gh/zhangsan/picx-images@main/images/my-photo.jpg

jsDelivr 是一个免费的全球 CDN，它会从 GitHub 拉取你的图片并缓存到全球节点，访问速度比直接访问 GitHub 快很多。注意：jsDelivr 有缓存机制，图片更新后可能需要几分钟才能在全球生效。如果图片链接打开是旧的版本，等几分钟再试。

九、PicX 还可以自部署

PicX 本身是一个纯前端项目（HTML + JavaScript），不依赖任何后端。你不一定要用作者提供的在线版本（picx.xpoet.cn），也可以自己部署一份，这样完全不受作者网站状态的影响。

自部署步骤（可选，极简）：

1. 打开 PicX 的 GitHub 仓库：https://github.com/XPoet/picx
2. 点击右上角的 Fork（复刻），把项目复制到你的 GitHub 账号下。
3. 在你 Fork 的仓库页面，点击 Settings（设置）→ Pages。
4. 在 Source 中选择 GitHub Actions。
5. 稍等片刻，GitHub Pages 会为你的 PicX 生成一个网址，格式为 https://你的用户名.github.io/picx/。
6. 以后你就可以用这个网址来访问你自己的 PicX 了。

自部署的好处：你使用的 PicX 实例完全由你自己的 GitHub 仓库提供服务，不受任何第三方网站稳定性的影响。

十、常见问题

Q1：图片链接打开是 404 怎么办？

检查以下几点：

1. 确认 GitHub 仓库是 Public（公开）的，不是 Private（私有）。
2. 确认图片已经成功推送到仓库中。去你的 GitHub 仓库页面看看，图片文件是否在里面。
3. jsDelivr 有缓存延迟。刚上传的图片可能需要等待 1-5 分钟才能通过 jsDelivr 链接访问。直接访问 GitHub 原始链接是即时生效的。

Q2：GitHub 仓库有存储限制吗？

有，但通常够用：

• 单个文件不超过 100MB。
• 仓库总大小建议不超过 1GB（超过后 GitHub 会发邮件提醒）。
• 对于图床用途来说，一张图片通常几百 KB 到几 MB，1GB 可以存几千张图片。

Q3：图片会不会丢失？

只要你的 GitHub 仓库没有被删除，图片就一直在。GitHub 是微软旗下的服务，稳定性极高。建议定期备份你的图片仓库（下载 ZIP 即可）。

Q4：Token 过期了怎么办？

如果你创建 Token 时设置了过期时间，过期后 PicX 将无法上传新图片。去 GitHub 重新生成一个 Token（参考 Step 3），然后在 PicX 设置中更新 Token 即可。

Q5：如何删除已上传的图片？

有两种方式：

• 在 PicX 中删除：在 PicX 的图片列表中，鼠标悬停在图片上，点击删除图标。
• 在 GitHub 中删除：直接去你的 GitHub 仓库，找到图片文件，点击删除。

Q6：PicX 安全吗？我的 Token 会不会泄露？

PicX 是纯前端应用，你的 Token 只存储在你浏览器的本地存储中，不会上传到任何第三方服务器。Token 只在向 GitHub API 发送请求时使用。如果你担心安全，可以创建一个只有这个仓库权限的 Token，万一泄露也只影响这一个仓库。

十一、总结

PicX 是目前最省心的图床方案之一，因为：

• 零成本：不需要买服务器、不需要买域名。
• 零运维：不需要安装环境、不需要维护升级。
• 图片永久有效：存储在 GitHub 上，比微博图床等随时可能挂掉的第三方服务靠谱。
• CDN 加速：通过 jsDelivr 全球加速，国内访问速度也还可以。

搭建流程概括：

1. 注册 GitHub 账号。
2. 创建一个公开的空仓库。
3. 生成一个 Token（权限勾选 repo）。
4. 打开 PicX 网站，填入仓库信息和 Token。
5. 上传图片，复制链接。

五分钟就能完成。如果你需要为博客、笔记、论坛找一个稳定免费的图床，PicX 是目前最好的选择之一。

项目地址：https://github.com/XPoet/picx
在线使用：https://picx.xpoet.cn