README.md

May 8, 2025 · View on GitHub

picgo-plugin-ftp-uploader

PicGo FTP 上传插件

配置

配置分为

  • 插件配置,在插件中配置
  • 配置文件配置,是需要自行创建一个 json 文件进行配置

插件配置

名称介绍配置示例
网站标识多个 FTP 站的标识site1
配置文件配置文件的路径或 URLD:/ftpUploader.json

关于配置文件

可以是本地文件,如 D:/ftpUploader.json 也可以是网络文件,如 https://imba97.cn/ftpUploader.json

配置文件配置

配置文件是一个 json 文件,你可以在里面配置多个 FTP 服务器的信息

例:

{
  "site1": {
    "url": "https://mysite1.com",
    "path": "/mysite1.com/{year}/{month}/{fullName}",
    "uploadPath": "/Web/mysite1.com/{year}/{month}/{fullName}",
    "host": "1.2.3.4",
    "port": 21,
    "username": "ftpUser1",
    "password": "ftpPassword1"
  },
  "site2": {
    "url": "https://mysite2.com",
    "path": "/mysite2.com/{year}/{month}/{fullName}",
    "uploadPath": "/Web/mysite2.com/{year}/{month}/{fullName}",
    "host": "1.2.3.4",
    "port": 21,
    "username": "ftpUser2",
    "password": "ftpPassword2"
  }
}
名称介绍配置示例
url图片网站的域名https://mysite.com
path图片的路径/uploads/{year}/{month}/{fullName}
uploadPath文件在 FTP 服务器的真实路径/blog/uploads/{year}/{month}/{fullName}
hostFTP 地址233.233.233.233
portFTP 端口21
username用户名imba97
password密码imba97

可通过配置网站标识 site1site2 来上传到不同的位置

路径 Format

路径配置可使用以下参数,使用示例:/{year}/{month}/{fullName},输出示例:/2020/01/imba97.png

名称介绍输出示例
year当前年份2021
month当前月份01
fullName图片全名imba97.png
fileName图片名称imba97
hash16图片 MD5 16 位68559cae1081d683
hash32图片 MD5 32 位68559cae1081d6836e09b043aa0b3af1
ext图片后缀名png

注意:除了 fullName,其他都需要自行添加后缀名

路径配置示例

网址路径文件路径 的配置示例

比如我服务器有这样一个路径:/www/wwwroot/blog/uploads/,图片在里面

我的网站根目录是 /www/wwwroot/blog/,而 FTP 根目录是 /www/wwwroot/

那么我可以把 网址路径 设置为 /uploads/{year}/{month}/{fullName}

文件路径 设置为 /blog/uploads/{year}/{month}/{fullName}