tcjlj/PicList
1
0
Fork 0
mirror of https://github.com/Kuingsmile/PicList.git synced 2025-01-22 14:28:12 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity
release
PicList/FAQ.md
Kuingsmile a9eed2d4de 📝 Docs(custom): update FAQ
2024-10-30 17:51:02 +08:00

6.4 KiB
Raw Permalink Blame History

FAQ

本 FAQ 修改自 PicGo 的 FAQ，感谢 PicGo 的作者 Molunerfinn。

常见问题

常规配置问题请参考 官方文档

1. PicList 和 PicGo 有什么关系？

PicList 项目是从 PicGo 项目 fork 而来，基于 PicGo 进行了二次开发。同时，核心功能内核 PicGo-Core 也进行了二次开发，并重命名为 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. 能否支持xxx图床

PicList本体支持了如下图床：

  • 七牛图床
  • AWS S3 兼容平台
  • 腾讯云 COS
  • 又拍云
  • GitHub
  • SM.MS
  • 阿里云 OSS
  • Imgur
  • Webdav
  • 本地图床
  • SFTP
  • 兰空图床
  • PicList(套娃)
  • 高级自定义图床

PicList计划整合和优化现有插件，内置更多的常用图床。

此外，PicList兼容PicGo的插件系统，需要其他图床支持可以参考目前已有的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 或以上版本。

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

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为你自己的密钥。

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文件中：

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为你自己的密钥。

然后运行

docker-compose up -d