Skip to content

Commit

Permalink
chore(docs): add warning about ubuntu snap
Browse files Browse the repository at this point in the history
  • Loading branch information
Lipraty authored Mar 15, 2024
2 parents 2ea426c + a8b99b5 commit 8198d9a
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,37 @@ koishi-plugin-puppeteer 提供了通用的浏览器服务,可用于网页截
为了正常使用这个插件,你首先需要确保你的电脑上已经安装有 Chrome / Edge / Firefox。同时,我们建议你保持浏览器和本插件的更新,因为版本不匹配可能会导致本插件无法正常使用。
:::

::: warning
由于 Ubuntu 在 19.10 以后转向[通过 snap 提供 Chromium 包](https://ubuntu.com/blog/chromium-in-ubuntu-deb-to-snap-transition),snap 会将 Chromium 隔离运行在一个沙箱中,只能访问受限的文件系统。

当 Chromium 浏览器在隔离环境下使用时, Koishi 会抛出以下错误:
```bash
[W] app Error: net::ERR_FILE_NOT_FOUND at file:///your-koishi-workspace-path/node_modules/koishi-plugin-puppeteer/index.html
```

<details>
<summary>点我查看解决方法</summary>

可以选择下列方法**之一**解决:
- 使用其他 Linux 发行版
- 使用传统 `deb` 包进行安装
```bash
> curl -o https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb chrome.deb
> dpkg chrome.deb
```
- 将你想使用的文件夹添加到 `snap` 应用程序访问列表中
```bash
sudo snap connect <snap app name>:your-koishi-workspace-path
```
- 移动到 `snap` 允许访问的文件夹或挂载点中(具体允许文件夹或挂载点请查询 snap 级别)
- `/home/$USER`: 用户家目录
- `/media`: 可移动媒体设备的挂载点
- ~~`/mnt`: 临时挂载点~~
- ~~`/tmp`: 临时文件夹~~

</details>
:::

## 相关生态

以下是本仓库提供的插件:
Expand Down

0 comments on commit 8198d9a

Please sign in to comment.