romancin/rclonebrowser

rclonebrowser-docker

基于 https://github.com/kapitainsky/RcloneBrowser 构建的Docker容器，包含带图形用户界面的RClone Browser。

!版本 !镜像大小 !***

镜像概述和主要用途

这是一个功能完整的RClone Browser Docker镜像（基于kapitainsky分支）。基于Alpine Linux构建，具有极小的镜像体积。已在Synology和QNAP设备上测试通过，理论上可在任何x86_64设备上运行。感谢@jlesage提供的GUI应用基础镜像。

使用方法

基本运行命令

bash
docker run -d --name=rclonebrowser \
-v /share/Container/rclonebrowser/config:/config \
-v /share/Container/rclonebrowser/media:/media \
-e GROUP_ID=0 -e USER_ID=0 -e TZ=Europe/Madrid \
-p 5800:5800 \
-p 5900:5900 \
romancin/rclonebrowser:latest

通过 http://你的主机IP:5800 访问RClone Browser图形界面。

核心配置说明

• 将本地端口映射到5800用于Web访问
• 将本地端口映射到5900用于VNC访问
• 将本地卷映射到/config（存储配置数据）
• 将本地卷映射到/media（访问媒体文件）

环境变量

通过-e参数可传递以下环境变量来自定义容器属性，格式为<变量名>=<值>。

数据卷

通过-v参数设置数据卷映射，格式为<主机目录>:<容器目录>[:权限]。

端口

通过-p参数映射端口，格式为<主机端口>:<容器端口>。容器内端口不可更改，主机端口可自定义。

用户/组ID

使用数据卷（-v参数）时，主机与容器间可能出现权限问题（如容器内用户在主机不存在）。可通过USER_ID和GROUP_ID环境变量指定应用运行的用户ID和组ID来避免此问题。

在主机上，通过以下命令获取数据卷所有者的ID：

bash
id <用户名>

输出示例：

uid=1000(myuser) gid=1000(myuser) groups=1000(myuser),4(adm),24(cdrom),27(sudo),46(plugdev),113(lpadmin)

其中uid（用户ID）和gid（组ID）即为应传递给容器的值。

安全

默认情况下，GUI访问通过未加密连接（HTTP或VNC）进行。可通过SECURE_CONNECTION环境变量启用加密连接，详见环境变量部分。

启用后：

• 通过浏览器访问时使用HTTPS连接，HTTP访问自动重定向到HTTPS
• 通过VNC客户端访问时使用SSL加密连接（少数VNC客户端支持，如SSVNC）

证书

容器需要以下证书文件，默认缺失时会生成自签名证书。所有文件均为PEM编码的x509证书。

注意：为避免浏览器或VNC客户端的证书有效性警告/错误，建议使用自己的有效证书。证书文件变更时，相关服务会自动重启。

VNC密码

可通过两种方式设置VNC密码：

• 使用VNC_PASSWORD环境变量
• 在/config卷根目录创建.vncpass_clear文件，包含明文密码。容器启动时会将其加密并移至.vncpass

VNC密码安全性取决于：

• 通信通道类型（加密/未加密）
• 主机访问安全性

使用VNC密码时，强烈建议启用安全连接，避免密码在未加密通道中传输。

注意：密码限制为8个字符，此限制来自Remote Framebuffer Protocol RFC（见7.2.2节），超过部分将被忽略。

Shell访问

要获取运行中容器的Shell访问，执行：

bash
docker exec -ti CONTAINER sh

其中CONTAINER是容器创建时的ID或名称（如rclonebrowser）。

反向代理

以下是NGINX反向代理配置示例，用于将请求路由到此容器。反向代理可基于主机名或URL路径路由HTTP请求。

基于主机名路由

在此场景下，不同主机名路由到不同应用/容器。例如，将rclonebrowser.domain.tld的请求代理到容器127.0.0.1:5800。

NGINX配置添加以下内容：

nginx
map $http_upgrade $connection_upgrade {
	default upgrade;
	''      close;
}

upstream rclonebrowser {
	# 若反向代理与Docker容器不在同一机器，此处使用Docker主机IP
	# 确保根据容器5800端口在主机的映射调整端口
	server 127.0.0.1:5800;
}

server {
	[...]

	server_name rclonebrowser.domain.tld;

	location / {
	        proxy_pass http://rclonebrowser;
	}

	location /websockify {
		proxy_pass http://rclonebrowser;
		proxy_http_version 1.1;
		proxy_set_header Upgrade $http_upgrade;
		proxy_set_header Connection $connection_upgrade;
		proxy_read_timeout 86400;
	}
}

基于URL路径路由

在此场景下，主机名相同，不同URL路径路由到不同应用/容器。例如，将server.domain.tld/rclonebrowser的请求代理到容器127.0.0.1:5800。

NGINX配置添加以下内容：

nginx
map $http_upgrade $connection_upgrade {
	default upgrade;
	''      close;
}

upstream rclonebrowser {
	# 若反向代理与Docker容器不在同一机器，此处使用Docker主机IP
	# 确保根据容器5800端口在主机的映射调整端口
	server 127.0.0.1:5800;
}

server {
	[...]

	location = /rclonebrowser {return 301 $scheme://$http_host/rclonebrowser/;}
	location /rclonebrowser/ {
		proxy_pass http://rclonebrowser/;
		location /rclonebrowser/websockify {
			proxy_pass http://rclonebrowser/websockify/;
			proxy_http_version 1.1;
			proxy_set_header Upgrade $http_upgrade;
			proxy_set_header Connection $connection_upgrade;
			proxy_read_timeout 86400;
		}
	}
}

支持或联系

遇到容器问题或有疑问？请[创建新issue]。

变更日志

v3.0.2 (2020/09/09)：更新至Alpine 3.12和当前版本Rclone
v3.0.0 (2019/03/22)：更新至RcloneBrowser 1.8.0版本
v1.0.1 (2019/09/22)：更新至jlesage的最新镜像并添加Jenkinsfile用于CI