dotwee/element-web

Element Web Docker镜像文档

镜像概述

Element（前身为Vector/Riot）是Matrix协议的Web客户端，用于安全、去中心化的实时通信。本Docker镜像项目负责每日检查Element新版本，自动生成并推送支持多架构的Docker镜像，方便用户快速部署Element Web客户端。与官方镜像相比，本镜像包含Nginx服务，并支持多种CPU架构，适配更广泛的运行环境。

核心功能与特性

• 多架构支持：兼容多种CPU架构，包括linux/386、linux/amd64、linux/arm/v6、linux/arm/v7、linux/arm64、linux/ppc64le、linux/s390x
• 每日自动更新：自动检测Element官方新版本，确保镜像始终为最新稳定版
• 内置Nginx服务：无需额外配置Web服务器，开箱即可运行
• 轻量级设计：优化镜像大小，适合快速部署和资源受限环境

使用场景

• 个人或企业部署私有Element Web客户端，连接Matrix homeserver
• 在不同架构设备（如x86服务器、ARM开发板、树莓派等）上运行Element
• 需要自动化更新Element客户端的场景

使用方法

拉取镜像

从GitHub Packages拉取：

bash
docker pull ghcr.io/dotwee/element-web:latest

从Docker Hub拉取：

bash
docker pull dotwee/element-web:latest

运行容器

基础运行命令（默认配置）：

bash
docker run --name element -p 8080:80 -d ghcr.io/dotwee/element-web

运行后可通过 http://localhost:8080 在浏览器访问Element客户端。

配置说明

Element客户端配置

通过挂载自定义config.json文件自定义Element配置（如默认homeserver、主题等）：

bash
docker run -v /host/path/config.json:/etc/element-web/config.json:ro --name element -p 8080:80 -d ghcr.io/dotwee/element-web

配置文件语法参考https://github.com/vector-im/element-web#configjson%E3%80%82

Nginx服务配置

如需自定义Web服务器（Nginx）配置，可挂载自定义nginx.conf文件：

bash
docker run -v /host/path/nginx.conf:/etc/nginx/nginx.conf:ro --name element -p 8080:80 -d ghcr.io/dotwee/element-web

Nginx配置语法参考Nginx官方文档（特别是入门指南）。

其他参考

• GitHub仓库：https://github.com/dotWee/docker-element-web
• GitHub Packages页面：https://github.com/dotWee/docker-element-web/pkgs/container/element-web
• Docker Hub页面：https://hub.docker.com/r/dotwee/element-web