Bonsai 项目常见问题解决方案

Bonsai 项目常见问题解决方案

bonsai Self-hosted family wiki engine / photoalbum 项目地址: https://gitcode.com/gh_mirrors/bonsai2/bonsai

项目基础介绍

Bonsai 是一个自托管的家庭维基引擎和照片专辑项目，旨在帮助家庭成员记录和分享家庭历史、照片和其他相关信息。该项目支持多语言，并且提供了丰富的功能，如 Markdown 页面、多媒体文件管理、人物标记、亲属关系管理、访问控制等。Bonsai 主要使用 .NET 8 作为编程语言，并结合了 Node.js 和其他相关技术来实现其功能。

新手使用注意事项及解决方案

1. Docker 安装问题

问题描述：新手在尝试使用 Docker 安装 Bonsai 时，可能会遇到 Docker 环境配置不正确或 Docker 命令执行失败的问题。

解决步骤：

1. 检查 Docker 安装：确保 Docker 已正确安装并运行。可以通过运行 docker --version 命令来验证。
2. 下载 Docker Compose 文件：从项目仓库中下载 docker-compose.yml 文件。
3. 配置环境变量：根据需要配置环境变量，如 HTTPS 访问、Google 或 Yandex 授权等。
4. 启动容器：使用 docker-compose up -d 命令启动容器。如果遇到权限问题，可以尝试使用 sudo 命令。

2. 数据库连接问题

问题描述：在启动 Bonsai 后，可能会遇到数据库连接失败的问题，导致无法正常访问应用。

解决步骤：

1. 检查数据库配置：确保 docker-compose.yml 文件中的数据库连接字符串正确无误。
2. 验证数据库服务：确保数据库容器已成功启动，并且可以通过 docker ps 命令查看其状态。
3. 检查日志：使用 docker logs <容器ID> 查看数据库容器的日志，查找可能的错误信息。
4. 重新启动服务：如果数据库配置正确但仍无法连接，尝试重新启动 Bonsai 服务。

3. 访问控制配置问题

问题描述：新手在配置访问控制时，可能会遇到权限设置不当或授权服务配置错误的问题。

解决步骤：

1. 配置授权服务：根据项目文档，配置 Google 或 Yandex 的授权服务，并获取 Client ID 和 Client Secret。
2. 编辑配置文件：在 docker-compose.yml 文件中，填写正确的授权服务配置信息。
3. 禁用密码认证：如果希望仅使用第三方授权服务，可以设置 Auth__AllowPasswordAuth=false。
4. 测试访问控制：启动服务后，尝试使用第三方授权服务登录，验证访问控制是否正常工作。

通过以上步骤，新手可以更好地理解和解决在使用 Bonsai 项目时可能遇到的问题，确保项目的顺利部署和运行。

bonsai Self-hosted family wiki engine / photoalbum 项目地址: https://gitcode.com/gh_mirrors/bonsai2/bonsai