本地、WebDAV 与 SFTP
这些图床将文件写入你自己的目录或服务器。请分别确认“文件写到了哪里”和“浏览器怎样访问它”。没有网站服务时，填写域名也不会自动把目录变成网站。
本地目录：先完成一次练习
图床 ID：local。只需可写的目录，不需要账号。
- 在文件管理器中创建目录，例如 Windows 的 D:\Pictures\PicList。
- 在 PicList 选择 图床 → 本地上传 → 新增配置。
- 配置名填写练习；设定路径 填上一步的完整目录。
- 设定自定义域名 和 设定网站路径 先留空，确认保存。
- 选择卡片并设为默认平台，上传一张 PNG，再在目标目录中检查文件。
| 界面 / JSON 字段 | 用途 | 示例 |
|---|---|---|
| 设定路径 / path | 实际写入目录 | D:\Pictures\PicList 或 /srv/www/images |
| 设定自定义域名 / customUrl | 可选的 HTTP(S) 访问前缀 | https://images.example.com |
| 设定网站路径 / webPath | 公开 URL 中的目录 | gallery/ |
不填 customUrl 时，返回的是本地路径。它适合验证上传流程或保存到本机；其他人无法通过这个路径访问你的图片。
已有静态网站时如何映射？
假设你的 Web 服务器已经把 /srv/www/images 作为 https://images.example.com 的根目录：path 填 /srv/www/images，customUrl 填 https://images.example.com，webPath 留空。photo.png 的磁盘位置是 /srv/www/images/photo.png，公开链接是 https://images.example.com/photo.png。
如果网站在 /gallery/ 路径提供这个目录，就把 webPath 填成 gallery/。用浏览器验证一张图，再用于文章。
WebDAV：连接可写的远端目录
图床 ID：webdavplist。准备服务提供的 WebDAV 地址和账号，并先用该服务自己的客户端确认能写入目标目录。
- 展开 图床 → WebDAV，添加配置。
- host 填服务主机与接口路径，例如 dav.example.com/remote.php/dav/files/USER。
- 如果服务地址使用 HTTPS，开启 sslEnabled；程序根据此选项构造协议，不要只依赖 host 中写了 https://。
- 本地填写 username、password，按服务要求选择 Basic 或 Digest。
- path 填 WebDAV 中的上传目录，例如 pictures/。保存、选中并测试一张图片。
| 字段 | 用途 |
|---|---|
| host / sslEnabled | WebDAV 接口地址与 HTTPS 开关 |
| username / password | 连接凭据，本地填写 |
| path | 服务中的写入目录 |
| authType | basic 或 digest |
| customUrl | 可选的公开访问前缀 |
| webpath | 公开网站中的目录映射；注意 JSON 使用小写 p |
| options | 可选的链接后缀 |
如果不填 customUrl，链接通常仍位于 WebDAV 服务地址下，可能要求登录。如果你已有单独的公开文件域名，填写 customUrl 与对应的 webpath；webpath 未填写时会跟随上传目录。
WebDAV 共享网页不一定是原始文件 URL。检查返回的响应是否为图片，而不是登录页或 HTML 分享页。
SFTP：用 SSH 传文件，以 HTTP 展示
图床 ID：sftpplist。准备 SSH 主机、端口、用户和可写目录，并确认这些文件已有 HTTP(S) 访问方式。
- 选择 图床 → SFTP，添加配置。
- host 填 SSH 主机名或 IP，port 默认 22；不要填完整的 sftp:// URL。
- 填 username，以及 password 或 privateKey。privateKey 是本机私钥文件的路径，不是要粘贴的私钥正文；有口令时填写 passphrase。
- uploadPath 填实际服务端目录，例如 /srv/www/images。
- customUrl 填 https://images.example.com；如果此域名对应上述目录的根，webPath 填 /。
- 保留权限字段默认值，除非明确需要修改且账号有权限。保存并测试。
| 字段 | 示例或用途 |
|---|---|
| host / port / username | SSH 连接 |
| password | 使用密码认证时填写 |
| privateKey / passphrase | 本地私钥文件路径与可选口令 |
| uploadPath | /srv/www/images |
| customUrl | https://images.example.com |
| webPath | / 或网站对应的目录，例如 gallery/ |
| fileMode / dirMode / fileUser | 可选权限与所有者设置，需要服务器授权 |
未设置 webPath 时，SFTP 可能使用 uploadPath 生成 URL；这会把 /srv/www/images 带进公开链接。根据 Web 服务器映射填写 webPath。如果没有 customUrl，程序会从 SSH 主机生成 HTTPS 前缀；仍需该主机真实提供相应的 Web 服务。
customUrl 必须是没有用户名、密码、查询参数或片段的 HTTP(S) 地址。SFTP 的传输端口通常不是 Web 服务端口。
常见问题与验证
| 现象 | 检查 |
|---|---|
| 本地找不到文件 | 当前配置的 path、最终文件名、是否写到了另一套目录 |
| WebDAV 401 | 账号、HTTPS 开关、Basic / Digest 与接口路径 |
| SFTP 无法连接 | SSH 主机、端口、用户、认证方式和私钥文件是否可读 |
| Permission denied | 上传目录与账号写权限；额外 chmod/chown 是否获准 |
| 上传成功但链接 404 | customUrl 与 webPath 是否对应实际网站映射 |
| 只在 PicList 中能预览 | 是否依靠 localhost 缓存或已认证的服务 |
这些图床可能使用本机缓存预览。localhost:36699 地址只供本机应用预览；文章应使用读者可打开的地址。相册删除记录、清理缓存、删除实际目标文件是三种操作，见相册与链接。