README.md

May 12, 2025 · View on GitHub

picgo-plugin-sftp-uploader

PicGo SFTP 上传插件

配置

配置分为“插件配置”和“配置文件配置”

插件配置是在插件中配置

配置文件配置是需要自行创建一个json文件进行配置

插件配置

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

关于配置文件

可以是本地文件,如 D:/sftpUploader.json

也可以是网络文件,如 https://imba97.cn/sftpUploader.json

配置文件配置

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

例:

{
  "site1": {
    "url": "https://mysite1.com",
    "path": "/mysite1.com/{year}/{month}/{fullName}",
    "uploadPath": "/Web/mysite1.com/{year}/{month}/{fullName}",
    "host": "1.2.3.4",
    "port": 22,
    "username": "root",
    "privateKey": "C:/Users/imba97/.ssh/id_rsa",
    "passphrase": "private_key_password",
    "fileUser": "www",
    "dirMode": "0755"
  },
  "site2": {
    "url": "https://mysite2.com",
    "path": "/mysite2.com/{year}/{month}/{fullName}",
    "uploadPath": "/Web/mysite2.com/{year}/{month}/{fullName}",
    "host": "1.2.3.4",
    "username": "root",
    "password": "ssh_password"
  }
}
key名称介绍配置示例是否必填
url域名地址图片网站的域名https://mysite.com
path网址路径图片在网址中的路径/uploads/{year}/{month}/{fullName}
uploadPath文件路径图片在服务器的真实路径/www/wwwroot/blog/uploads/{year}/{month}/{fullName}
hostSSH 地址一般是服务器 IP233.233.233.233
port端口22
username用户名SSH 登录用户www
password密码SSH 用户登录密码cGFzc3dvcmQ=
privateKey私钥SSH 连接私钥C:/Users/imba97/.ssh/id_rsa
passphrase私钥密码SSH 连接私钥密码cGFzc3BocmFzZQ==
fileUser文件所属用户文件的所属用户:用户组,如果跟上传用户不同可填写,用户名和用户组名相同时,可不写“:”www
dirMode文件夹 mode文件夹读写权限0755

最终返回的地址是 域名地址 + 网址路径

路径 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/

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

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