zxdong262/electerm-web

electerm-web-docker

electerm-web的Docker镜像，用于在浏览器中提供终端访问和远程连接管理功能。

镜像概述

本镜像封装了https://github.com/electerm/electerm-web%EF%BC%8C%E8%BF%99%E6%98%AF%E4%B8%80%E4%B8%AAWeb%E7%89%88%E7%9A%84%E7%BB%88%E7%AB%AF%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%85%81%E8%AE%B8%E7%94%A8%E6%88%B7%E9%80%9A%E8%BF%87%E6%B5%8F%E8%A7%88%E5%99%A8%E8%AE%BF%E9%97%AE%E7%BB%88%E7%AB%AF%E7%95%8C%E9%9D%A2%EF%BC%8C%E7%AE%A1%E7%90%86%E8%BF%9C%E7%A8%8B%E6%9C%8D%E5%8A%A1%E5%99%A8%E8%BF%9E%E6%8E%A5%E3%80%82%E9%80%9A%E8%BF%87Docker%E9%83%A8%E7%BD%B2%E5%8F%AF%E7%AE%80%E5%8C%96%E5%AE%89%E8%A3%85%E6%B5%81%E7%A8%8B%EF%BC%8C%E5%AE%9E%E7%8E%B0%E6%95%B0%E6%8D%AE%E6%8C%81%E4%B9%85%E5%8C%96%EF%BC%8C%E5%B9%B6%E6%94%AF%E6%8C%81%E7%81%B5%E6%B4%BB%E7%9A%84%E9%85%8D%E7%BD%AE%E9%80%89%E9%A1%B9%E3%80%82

核心功能与特性

• 浏览器访问：通过Web浏览器直接访问终端界面，无需安装桌面客户端
• 数据持久化：支持将配置数据存储在宿主机目录，确保数据不丢失
• 认证保护：可选启用登录认证功能，通过密码保护Web访问
• 灵活配置：支持自定义加密密钥、监听地址、端口映射等参数
• 跨平台兼容：可在Linux、macOS、Windows系统上部署

使用场景

• 个人用户通过Web界面管理远程服务器
• 团队共享终端访问权限（需配置认证）
• 快速部署临时终端环境进行测试或演示
• 整合到Web应用中提供终端功能

使用方法

基本部署命令

sh
# 将$(pwd)/electerm-web-data替换为你想要存储数据的文件夹
# 如需与桌面版electerm共享数据：
# macOS系统：将$(pwd)/electerm-web-data修改为"/Users/<你的用户名>/Library/Application Support/electerm"
# Linux系统：将$(pwd)/electerm-web-data修改为"/home/<你的用户名>/.config/electerm"
# Windows系统：将$(pwd)/electerm-web-data修改为"C:\\Users\\<你的用户名>\\AppData\\Roaming\\electerm"

# SERVER_SECRET、SERVER_PASS、ENABLE_AUTH为可选参数
# 启用ENABLE_AUTH后，访问时需要使用SERVER_PASS登录
# SERVER_SECRET用于加密数据，未设置则使用默认值
# 应将some_server_secret替换为复杂的密钥字符串

docker run --init -v $(pwd)/electerm-web-data:/home/electerm/data \
  -e "DB_PATH=/home/electerm/data" \
  -e "HOST=0.0.0.0" \
# -e "SERVER_SECRET=some_server_secret" \  # 自定义加密密钥
# -e "SERVER_PASS=password_to_login" \      # 登录密码
# -e "ENABLE_AUTH=1" \                      # 启用认证（取消注释启用）
  -p 8082:5577 \
  zxdong262/electerm-web

部署完成后，访问 [***] 即可打开Web终端界面。

环境变量说明

Docker Compose 示例

yaml
version: '3.8'
services:
  electerm-web:
    image: https://docker.xuanyuan.me/zxdong262/electerm-web:latest
    container_name: electerm-web
    volumes:
      - /your/local/folder:/home/electerm/data
    environment:
      - DB_PATH=/home/electerm/data
      - HOST=0.0.0.0
      - SERVER_SECRET=some_server_secret
      - SERVER_PASS=password_to_login
      - ENABLE_AUTH=1
    ports:
      - "8082:5577"
    init: true

配置说明：

• 镜像选择：中国用户建议使用 https://docker.xuanyuan.me/zxdong262/electerm-web:latest，其他地区用户使用默认镜像
• 数据目录：将宿主机目录 /your/local/folder 挂载到容器内 /home/electerm/data，根据存储需求调整路径，确保当前用户对该目录有读写权限
• 网络配置：HOST=0.0.0.0 配置服务监听所有网络接口
• 端口映射：宿主机端口 8082 映射到容器端口 5577，实现外部访问

Docker Hub 地址

https://hub.docker.com/repository/docker/zxdong262/electerm-web

许可证

MIT