mirror of
https://github.com/Kuingsmile/PicList.git
synced 2025-01-23 14:48:13 -05:00
162 lines
6.3 KiB
Markdown
162 lines
6.3 KiB
Markdown
# FAQ
|
||
|
||
该FAQ修改自PicGo的FAQ，感谢PicGo的作者Molunerfinn。
|
||
|
||
## 常见问题
|
||
|
||
> 本软件的上传工具部分来自PicGo，基本没有改动，请参考PicGo的 [使用文档](https://picgo.github.io/PicGo-Doc/zh/guide/getting-started.html#%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B)
|
||
|
||
## 1. PicList和PicGo有什么关系？
|
||
|
||
PicList项目fork自PicGo项目，基于PicGo进行了二次开发，同时核心功能内核PicGo-Core也进行了二次开发，重命名为[PicList-Core](https://github.com/Kuingsmile/PicList-Core)。
|
||
|
||
PicList所有新功能的添加没有影响到PicGo的原有功能，所以你可以在PicList中使用PicGo的所有插件。同时仍然可以配合typora、obsidian等软件进行使用。
|
||
|
||
## 2. 使用图床管理功能时，出现无法获取目录等错误
|
||
|
||
请查看日志文件 `manage.log`，此外，各平台的API调用基本都有每小时次数限制，如果出现错误，请稍后再试。
|
||
|
||
## 3. 支持哪些图床远端同步删除
|
||
|
||
目前支持的图床有：
|
||
|
||
- 阿里云 OSS
|
||
- 腾讯云 COS
|
||
- 七牛云 Kodo
|
||
- 又拍云
|
||
- SM.MS
|
||
- Imgur
|
||
- GitHub
|
||
- WebDav
|
||
- Aws S3
|
||
- 本地路径
|
||
- 内置SFTP
|
||
- 多吉云
|
||
- 华为云 OBS
|
||
- Alist
|
||
|
||
## 4. 能否支持上传视频文件
|
||
|
||
可以，通过新添加的图床管理功能，你可以上传任意格式的文件，包括视频文件。同时，在管理界面内上传时，使用分片上传/流式上传等方式，相对于PicGo内置的转换为base64的方式，上传更快，更稳定。
|
||
|
||
## 5. 能否支持某某某图床
|
||
|
||
PicList本体支持了如下图床：
|
||
|
||
- `七牛图床`
|
||
- `腾讯云 COS`
|
||
- `又拍云`
|
||
- `GitHub`
|
||
- `SM.MS`
|
||
- `阿里云 OSS`
|
||
- `Imgur`
|
||
- `Webdav`
|
||
- `本地图床`
|
||
- `SFTP`
|
||
|
||
PicList计划整合和优化现有插件，内置更多的常用图床。
|
||
|
||
此外，PicList兼容PicGo的插件系统，需要其他图床支持可以参考目前已有的PicGo三方 [插件](https://github.com/PicGo/Awesome-PicGo)，如果还是没有你所需要的图床欢迎开发一个插件供大家使用。
|
||
|
||
## 6. Github 图床有时能上传，有时上传失败
|
||
|
||
GitHub 服务器和国内 GFW 的问题会导致有时上传成功，有时上传失败，无解。
|
||
|
||
想要稳定请使用付费云存储，如阿里云、腾讯云等，价格也不会贵。
|
||
|
||
## 7. Mac 上无法打开 PicList 的主窗口界面
|
||
|
||
要打开主窗口，请右键或者双指点按顶部栏 PicList 图标，选择「打开主窗口」即可打开主窗口。
|
||
|
||
或者在dock栏中右键PicList图标，选择「打开主窗口」。
|
||
|
||
## 8. 上传失败，或者是服务器出错
|
||
|
||
1. PicList 自带的图床都经过测试，上传出错一般都不是 PicList 自身的原因。如果你用的是 GitHub 图床请参考上面的第 7 点。
|
||
2. 检查 PicList 的日志（报错日志可以在 PicList 设置 -> 设置日志文件 -> 点击打开 后找到），看看 `[PicList Error]` 的报错信息里有什么关键信息
|
||
1. 先自行搜索 error 里的报错信息，往往你能百度或者谷歌出问题原因，不必开 issue。
|
||
2. 如果有带有 `401` 、`403` 等 `40X` 状态码字样的，不用怀疑，就是你配置写错了，仔细检查配置，看看是否多了空格之类的。
|
||
3. 如果带有 `HttpError`、`RequestError` 、 `socket hang up` 等字样的说明这是网络问题，我无法帮你解决网络问题，请检查你自己的网络，是否有代理，DNS 设置是否正常等。
|
||
3. 通常网络问题引起的上传失败都是因为代理设置不当导致的。如果开启了系统代理，建议同时也在 PicList 的代理设置中设置对应的HTTP代理。
|
||
|
||
## 10. macOS版本安装完之后没有主界面
|
||
|
||
请找到PicList在顶部栏的图标，然后右键（触摸板双指点按，或者鼠标右键），即可找到「打开主窗口」的菜单。
|
||
|
||
或者再Docker栏PicList的图标上右键，即可找到「打开主窗口」的菜单。
|
||
|
||
## 11. macOS系统安装完PicList显示「文件已损坏」或者安装完打开没有反应
|
||
|
||
请升级PicList 1.4.1或以上版本，自1.4.1开始，PicList已经经过Apple的签名，不会再出现这种情况。
|
||
|
||
## 12. 水印没有正常添加
|
||
|
||
PicList在添加水印前会先检查字体文件是否存在，如果不存在会自动下载字体文件，但是由于网络问题，可能会导致字体文件下载失败，此时会跳过水印添加。
|
||
|
||
请根据自己的系统检查对应路径下的字体文件是否存在，如果不存在，请手动下载字体文件，然后放到对应的路径下。
|
||
|
||
Windows: `%APPDATA%\piclist\assets\simhei.ttf`
|
||
Linux: `$XDG_CONFIG_HOME/piclist/assets/simhei.ttf` or `~/.config//assets/simhei.ttf`
|
||
macOS: `~/Library/Application\ Support/picgo/assets/simhei.ttf`
|
||
|
||
字体文件下载地址：[https://release.piclist.cn/simhei.ttf](https://release.piclist.cn/simhei.ttf)
|
||
|
||
## 13. 使用aws-s3插件上传到cloudflare R2时出现上传失败问题
|
||
|
||
R2的endpoint地址会出现被GFW sni阻断的问题，查看piclist.log后将对应的ip地址加入代理列表可解决。
|
||
|
||
## 14. PicList兼容所有的PicGo插件吗？
|
||
|
||
PicList兼容绝大部分的PicGo插件。然而由于PicList使用了更新的electron版本，与旧版本的sharp库不兼容，所以部分插件可能无法使用。
|
||
|
||
已知的无法使用的插件有：
|
||
|
||
- picgo-plugin-watermark (已经内置)
|
||
- picgo-plugin-pic-migrater (该插件会校验PicGo的版本，无法使用，请换用pic-migrater-piclist插件)
|
||
- picgo-plugin-auto-delete (已经内置)
|
||
|
||
欢迎大家测试其他插件，如果有无法使用的插件，欢迎开issue反馈。
|
||
|
||
## 15. 如何通过Docker运行PicList-core?
|
||
|
||
### docker run
|
||
|
||
修改`./piclist`为你自己的路径，修改`piclist123456`为你自己的密钥。
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name piclist \
|
||
--restart always \
|
||
-p 36677:36677 \
|
||
-v "./piclist:/root/.piclist" \
|
||
kuingsmile/piclist:latest \
|
||
node /usr/local/bin/picgo-server -k piclist123456
|
||
```
|
||
|
||
### docker-compose
|
||
|
||
下载piclist-core仓库的`docker-compose.yml`文件，或者复制以下内容到`docker-compose.yml`文件中：
|
||
|
||
```yaml
|
||
version: '3.3'
|
||
|
||
services:
|
||
node:
|
||
image: 'kuingsmile/piclist:latest'
|
||
container_name: piclist
|
||
restart: always
|
||
ports:
|
||
- 36677:36677
|
||
volumes:
|
||
- './piclist:/root/.piclist'
|
||
command: node /usr/local/bin/picgo-server -k piclist123456
|
||
```
|
||
|
||
你可以修改`volumes`为你自己的路径，修改`command`为你自己的密钥。
|
||
|
||
然后运行
|
||
|
||
```bash
|
||
docker-compose up -d
|
||
```
|