arnoldsmith86/virtualtabletop

VirtualTabletop.io 官方Docker镜像

镜像概述和主要用途

本镜像为VirtualTabletop.io的官方Docker镜像，用于快速部署虚拟桌面服务器。源代码托管于https://github.com/ArnoldSmith86/virtualtabletop%EF%BC%8C%E4%B8%8E%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E4%B8%80%E8%87%B4%EF%BC%8C%60main%60%E5%88%86%E6%94%AF%E7%9A%84%E6%AF%8F%E6%AC%A1%E6%8F%90%E4%BA%A4%E9%83%BD%E4%BC%9A%E8%87%AA%E5%8A%A8%E6%9B%B4%E6%96%B0%E9%95%9C%E5%83%8F%E3%80%82

核心功能和特性

• 自动更新：基于main分支提交自动更新
• 灵活配置：通过环境变量自定义服务器参数
• 数据持久化：支持卷挂载保存房间数据
• 轻量化选项：提供不含公共游戏库的镜像标签，减小镜像体积
• 反向代理兼容：支持通过Nginx等反向代理部署

标签说明

• 默认标签：包含完整公共游戏库
• without-public-library：不含公共游戏库，镜像体积更小

使用场景和适用范围

• 本地测试和开发
• 个人或小团队私有服务器部署
• 公共服务器部署（需配合反向代理和SSL）
• 自定义游戏库管理

使用方法和配置说明

基础使用示例

本地仅访问服务器

在http://localhost:8272运行默认配置的本地服务器：

bash
docker run -p 8272:8272 arnoldsmith86/virtualtabletop

自定义端口和数据持久化

在服务器80端口运行，将房间数据保存到/srv/vtt目录：

bash
docker run -e EXTERNALURL=http://mydomain.com -v /srv/vtt:/app/save -p 80:8272 arnoldsmith86/virtualtabletop

反向代理配置

通过Nginx反向代理时，设置外部URL和路径前缀：

bash
docker run -e EXTERNALURL=https://mydomain.com/vtt -e URLPREFIX=/vtt -p 8272:8272 arnoldsmith86/virtualtabletop

Nginx反向代理示例

以下配置实现SSL termination并反向代理到Docker容器，确保WebSocket连接正常工作（假设已通过Certbot获取证书）：

nginx
user www-data;
worker_processes auto;
pid /run/nginx.pid;

events {
  worker_connections 768;
}

http {
  server_tokens off;

  add_header X-Frame-Options SAMEORIGIN;
  add_header X-Content-Type-Options nosniff;
  add_header X-XSS-Protection "1; mode=block";

  server {
    listen 80 default_server;
    listen [::]:80 default_server;
    server_name virtualtabletop.io;
    return 301 https://virtualtabletop.io$request_uri;
  }

  server {
    server_name virtualtabletop.io;

    listen 127.0.0.1:443 ssl;
    ssl_certificate /etc/letsencrypt/live/virtualtabletop.io/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/virtualtabletop.io/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    client_max_body_size 200M;
    add_header Strict-Transport-Security "max-age=31536000; includeSubdomains; preload";

    location / {
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header Host $host;
      proxy_pass http://127.0.0.1:8272;

      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
      proxy_connect_timeout 1d;
      proxy_send_timeout 1d;
      proxy_read_timeout 1d;
    }
  }
}

自定义公共游戏库

使用自定义游戏库（需使用without-public-library标签）：

bash
docker run -e ALLOWPUBLICLIBRARYEDITS=1 -v /srv/vtt-games:/app/library/games -p 8272:8272 arnoldsmith86/virtualtabletop:without-public-library

注意：ALLOWPUBLICLIBRARYEDITS=1允许通过应用编辑游戏库，建议配置完成后移除该参数以禁用公共编辑权限。

环境变量配置

常用环境变量

次要环境变量

故障排除

• 问题：可访问服务器但图片和菜单显示异常
  原因：访问URL与EXTERNALURL配置不一致
  解决：确保访问地址与EXTERNALURL设置完全匹配