FoundryVTT Docker 项目常见问题解决方案

FoundryVTT Docker 项目常见问题解决方案

foundryvtt-docker An easy-to-deploy Dockerized Foundry Virtual Tabletop server. 项目地址: https://gitcode.com/gh_mirrors/fo/foundryvtt-docker

项目基础介绍

FoundryVTT Docker 项目是一个用于快速部署 Foundry Virtual Tabletop 服务器的 Docker 容器解决方案。Foundry Virtual Tabletop 是一个用于角色扮演游戏的虚拟桌面平台，允许用户创建和管理游戏会话。该项目的主要编程语言是 Shell 脚本和 Python，用于配置和自动化部署过程。

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

1. Docker 安装问题

问题描述：新手用户在安装 Docker 时可能会遇到各种问题，例如依赖缺失、权限不足等。

解决步骤：

1. 检查系统要求：确保操作系统满足 Docker 的最低要求（例如，64 位 Linux 或 Windows 10 专业版）。
2. 安装 Docker：根据官方文档安装 Docker。对于 Linux 系统，可以使用包管理器（如 apt 或 yum）安装 Docker。对于 Windows 系统，可以从 Docker 官网下载安装包。
3. 验证安装：安装完成后，运行 docker --version 命令验证 Docker 是否正确安装。

2. FoundryVTT 许可证问题

问题描述：用户在启动容器时需要提供 FoundryVTT 的许可证信息，如果信息错误或缺失，容器将无法启动。

解决步骤：

1. 获取许可证信息：登录 FoundryVTT 官网，获取许可证的用户名和密码，或者生成一个临时的下载 URL。
2. 配置环境变量：在启动 Docker 容器时，通过环境变量传递许可证信息。例如：

   docker run --env FOUNDRY_USERNAME='<your_username>' --env FOUNDRY_PASSWORD='<your_password>' --publish 30000:30000/tcp --volume <your_data_dir>:/data felddy/foundryvtt:release
   

3. 验证许可证：启动容器后，访问 FoundryVTT 的 Web 界面，确认许可证信息是否正确加载。

3. 数据持久化问题

问题描述：用户在重启 Docker 容器后，发现 FoundryVTT 的数据丢失，无法恢复之前的游戏进度。

解决步骤：

1. 挂载数据卷：在启动 Docker 容器时，使用 --volume 参数将本地目录挂载到容器内的数据目录。例如：

   docker run --env FOUNDRY_USERNAME='<your_username>' --env FOUNDRY_PASSWORD='<your_password>' --publish 30000:30000/tcp --volume /path/to/local/data:/data felddy/foundryvtt:release
   

2. 备份数据：定期备份挂载的本地目录，以防止数据丢失。可以使用 rsync 或 tar 等工具进行备份。
3. 验证数据持久化：重启容器后，检查挂载的本地目录是否包含之前的游戏数据。

通过以上步骤，新手用户可以更好地理解和使用 FoundryVTT Docker 项目，避免常见问题的发生。

foundryvtt-docker An easy-to-deploy Dockerized Foundry Virtual Tabletop server. 项目地址: https://gitcode.com/gh_mirrors/fo/foundryvtt-docker