配置文件

picgo需要配置文件来启动。当你未指定配置文件的时候,picgo将会使用默认配置文件来启动。

默认配置文件

picgo的默认配置文件为~/.picgo/config.json。其中~为用户目录。不同系统的用户目录不太一样。

linux和macOS均为~/.picgo/config.json

windows则为C:\Users\你的用户名\.picgo\config.json

配置文件需要至少有如下的配置项:

{
  "picBed": {
    "uploader": "smms" // 代表当前的默认上传图床为SM.MS
  },
  "picgoPlugins": {} // 为插件预留
}
1
2
3
4
5
6

picBed

作为picgo最主要的配置项,picBed里包括了当前上传图床,以及所有上传图床的配置。

插件开发者注意

如果一个Uploader的名字为xxx,那么它的配置信息会放置在picBed.xxx里。这个将有助于PicGo的electron版本进行配置。

picBed.uploader

  • type: string
  • default: smms

表明当前的上传图床是哪个。默认值是smms。(它不需要额外配置)

picBed.current

作用与picBed.uploader一致,主要是为了兼容PicGo的electron版本而留下的配置。未来有可能抛弃。

picBed.weibo

微博图床的相关配置。可以查看PicGo的wiki进行配置。

默认值如下:

{
  "chooseCookie": true | false, // 使用cookie模式?
  "username": "", // 若不用cookie模式必须提供用户名和密码
  "password": "", // 若不用cookie模式必须提供用户名和密码
  "quality": "thumbnail" | "mw690" | "large", // 图片质量,默认large
  "cookie": "" // 使用cookie模式必须提供cookie值
}
1
2
3
4
5
6
7

picBed.qiniu

七牛图床的相关配置。可以查看PicGo的wiki进行配置。

默认值如下:

{
  "accessKey": "",
  "secretKey": "",
  "bucket": "", // 存储空间名
  "url": "", // 自定义域名
  "area": "z0" | "z1" | "z2" | "na0" | "as0", // 存储区域编号
  "options": "", // 网址后缀,比如?imgslim
  "path": "" // 自定义存储路径,比如img/
}
1
2
3
4
5
6
7
8
9

picBed.upyun

又拍云的相关配置。可以查看PicGo的wiki进行配置。

默认值如下:

{
  "bucket": "", // 存储空间名,及你的服务名
  "operator": "", // 操作员
  "password": "", // 密码
  "options": "", // 针对图片的一些后缀处理参数
  "path": "", // 自定义存储路径,比如img/
  "url": "" // 加速域名,注意要加http://或者https://
}
1
2
3
4
5
6
7
8

picBed.tcyun

腾讯云COS的相关配置。可以查看PicGo的wiki进行配置。

默认值如下:

{
  "secretId": "",
  "secretKey": "",
  "bucket": "", // 存储桶名,v4和v5版本不一样
  "appId": "",
  "area": "", // 存储区域,例如ap-beijing-1
  "path": "", // 自定义存储路径,比如img/
  "customUrl": "", // 自定义域名,注意要加http://或者https://
  "version": "v5" | "v4" // COS版本,v4或者v5
}
1
2
3
4
5
6
7
8
9
10

picBed.github

GitHub图床的相关配置。可以查看PicGo的wiki进行配置。

默认值如下:

{
  "repo": "", // 仓库名,格式是username/reponame
  "token": "", // github token
  "path": "", // 自定义存储路径,比如img/
  "customUrl": "", // 自定义域名,注意要加http://或者https://
  "branch": "" // 分支名,默认是master
}
1
2
3
4
5
6
7

picBed.aliyun

阿里云OSS的相关配置。可以查看PicGo的wiki进行配置。

默认值如下:

{
  "accessKeyId": "",
  "accessKeySecret": "",
  "bucket": "", // 存储空间名
  "area": "", // 存储区域代号
  "path": "", // 自定义存储路径
  "customUrl": "" // 自定义域名,注意要加http://或者https://
}
1
2
3
4
5
6
7
8

picBed.imgur

Imgur的相关配置。可以查看PicGo的wiki进行配置。

默认值如下:

{
  "clientId": "", // imgur的clientId
  "proxy": "" // 代理地址,仅支持http代理
}
1
2
3
4

picgoPlugins

这个配置项将会将所有插件名放置进去。主要用于判断插件是否被启用或者禁用。 picgo自动生成,不需要配置!

示例:

{
  "picgo-plugin-xxx": true, // 该插件被启用
  "picgo-plugin-yyy": false // 该插件被禁用
}
1
2
3
4

transformer

这个配置项主要用于存放第三方插件里的Transformer的相关配置。

插件开发者注意

如果一个Transformer的名字为xxx,那么它的配置信息会放置在transformer.xxx里。这将有助于PicGo的electron版本进行配置。

默认值:{}

picgo-plugin-*

如果你为picgo开发了一个插件,如果这个插件本身需要一些配置项,那么这个插件对应的配置应该直接放置在配置文件下的同名配置里:

示例:

"picgo-plugin-xxx": {
  "config1": "",
  "config2": ""
}
1
2
3
4