picgo-plugin-sftp-uploader

PicGo SFTP 上传插件，原 picgo-plugin-ssh-scp-uploader

配置

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

插件配置是在插件中配置

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

插件配置

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

关于配置文件

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

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

配置文件配置

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

例：

{
  "imba97": {
    "url": "https://imba97.cn",
    "path": "/uploads/{year}/{month}/{fullName}",
    "uploadPath": "/www/imba97_cn/uploads/{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"
  },
  "btools": {
    "url": "https://btools.cc",
    "path": "/uploads/{year}/{month}/{fullName}",
    "uploadPath": "/www/btools_cc/uploads/{year}/{month}/{fullName}",
    "host": "1.2.3.4",
    "username": "root",
    "password": "ssh_password"
  }
}

key	名称	介绍	配置示例	是否必填
url	域名地址	图片网站的域名	https://imba97.cn	是
path	网址路径	图片在网址中的路径	/uploads/{year}/{month}/{fullName}	是
uploadPath	文件路径	图片在服务器的真实路径	/www/wwwroot/blog/uploads/{year}/{month}/{fullName}	是
host	SSH 地址	一般是服务器 IP	233.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}

用户名|私钥配置示例

有两种方案

用户名 + 密码

一般会用这种方式，只需要在

用户名|密钥 配置 SSH 连接用的用户名

密码/密钥密码 配置 SSH 连接的密码即可
用户名 + 私钥 + 私钥密码

私钥是使用ssh-keygen生成的，Windows 系统默认创建位置是C:\Users\xxx\.ssh\id_rsa

生成及配置密钥的过程可参考《搭建自己的 Git 服务器》中的创建 SSH部分

完成后可以登录测试一下，再在用户名|密钥配置：
```
www|C:\Users\xxx\.ssh\id_rsa
```
www是用户名，中间用|隔开，后面是保存在本地的私钥文件路径

密码/密钥密码配置创建密钥时输入的密码，如果没有私钥密码可留空

**注意：**如果是宝塔的www用户，还需要修改/etc/passwd
```
# 打开 passwd
vim /etc/passwd
# 找到这一行
www:x:1000:1000::/home/www:/sbin/nologin
# 改成
www:x:1000:1000::/home/www:/bin/bash
```

picgo-plugin-sftp-uploader