Remmina Docker镜像（Unraid优化版）

1. 镜像概述与主要用途

Remmina是一款适用于基于POSIX操作系统的远程桌面客户端，支持远程桌面协议（RDP）、VNC、NX、XDMCP、SPICE及SSH等多种协议。本Docker镜像对Remmina进行了封装，并针对Unraid系统进行了优化，允许用户通过VNC协议访问Remmina客户端，从而便捷地管理远程桌面会话。

2. 核心功能与特性

• 多协议支持：兼容RDP、VNC、NX、XDMCP、SPICE及SSH远程连接协议
• Web化访问：通过VNC协议提供浏览器访问界面，无需安装本地客户端
• 自定义分辨率：可通过环境变量配置远程会话的屏幕分辨率
• 数据持久化：支持配置文件与会话数据的持久化存储
• Unraid优化：针对Unraid平台进行适配，提升系统兼容性与部署便捷性

3. 使用场景与适用范围

• Unraid服务器用户：需要在Unraid环境中集中管理远程桌面连接的场景
• 多协议远程访问需求：需通过单一客户端连接不同协议远程设备的用户
• 服务器运维管理：管理员通过浏览器便捷访问多台远程服务器或工作站
• 轻量级远程管理：无需安装本地客户端，直接通过Web界面进行远程会话管理

4. 环境变量配置

5. 使用方法

5.1 Docker运行命令

docker run --name Remmina -d \
    -p 8080:8080 \
    --env 'CUSTOM_RES_W=1280' \
    --env 'CUSTOM_RES_H=1024' \
    --env 'UID=99' \
    --env 'GID=100' \
    --env 'UMASK=000' \
    --env 'DATA_PERM=770' \
    --volume /mnt/user/appdata/remmina:/remmina \
    --restart=unless-stopped \
    ich777/remmina

5.2 WebGUI访问地址

通过以下URL访问Remmina客户端界面：
http://[服务器IP]:[端口]/vnc.html?autoconnect=true
（将[服务器IP]替换为Docker主机IP，[端口]替换为映射的主机端口，默认8080）

6. Nginx反向代理配置示例

如需通过域名访问并启用HTTP基础认证，可参考以下Nginx配置：

server {
    listen 443 ssl;

    include /config/nginx/ssl.conf;
    include /config/nginx/error.conf;

    server_name rdp.example.com;  # 替换为实际域名

    location /websockify {
        auth_basic           example.com;  # 认证提示信息
        auth_basic_user_file /config/nginx/.htpasswd;  # 替换为.htpasswd文件路径
        proxy_http_version 1.1;
        proxy_pass [***]  # 替换为Docker主机IP和端口
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        # VNC连接超时时间
        proxy_read_timeout 61s;

        # 禁用缓存
        proxy_buffering off;
    }
    location / {
        rewrite ^/$ [***] redirect;  # 替换为实际域名
        auth_basic           example.com;  # 认证提示信息
        auth_basic_user_file /config/nginx/.htpasswd;  # 替换为.htpasswd文件路径
        proxy_redirect     off;
        proxy_set_header Range $http_range;
        proxy_set_header If-Range $http_if_range;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_pass [***]  # 替换为Docker主机IP和端口
    }
}

注意：请根据实际环境修改配置中的域名、IP地址、端口及.htpasswd文件路径。

7. 支持与反馈

• 支持线程：[***]