mosswill/isaiah

Isaiah

概述

Isaiah是一个自托管服务，允许您在远程服务器上管理所有Docker资源。它尝试从零开始重建https://github.com/jesseduffield/lazydocker%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%BA%94%E7%94%A8%EF%BC%8C%E5%90%8C%E6%97%B6%E5%B0%86%E5%85%B6%E4%BD%9C%E4%B8%BAWeb%E5%BA%94%E7%94%A8%E6%8F%90%E4%BE%9B%EF%BC%8C%E4%B8%94%E4%B8%8D%E7%89%BA%E7%89%B2%E4%BB%BB%E4%BD%95%E5%8A%9F%E8%83%BD%E3%80%82

核心功能与特性

容器管理

• 批量停止、批量删除、清理
• 删除、暂停、恢复、重启、浏览器中打开
• 从浏览器在容器内打开shell
• 查看详情（实时日志、统计信息、环境变量、完整配置、进程列表）

镜像管理

• 清理
• 删除
• 运行（使用镜像创建并启动容器）
• 在Docker Hub中打开
• 拉取新镜像（从Docker Hub）
• 查看详情（完整配置、分层信息）

卷管理

• 清理
• 删除
• 浏览卷文件（通过浏览器shell）
• 查看详情（完整配置）

网络管理

• 清理
• 删除
• 查看详情（完整配置）

其他核心特性

• 内置Docker主机自动发现
• 内置主密码认证
• 内置终端模拟器（支持在服务器上打开shell）
• 支持桌面、平板和移动设备的响应式设计
• 多布局支持
• 自定义CSS主题（已定义颜色变量）
• 键盘导航支持
• 鼠标导航支持
• 自定义Docker主机/上下文支持
• 通过.env文件进行 extensive 配置
• HTTP和HTTPS支持
• 独立/代理部署支持

技术特点

• 服务端使用Go编写，客户端使用原生JS
• 单个可执行文件约4MB
• Docker镜像约4MB
• 完全通过Websocket工作，带宽占用极低
• 使用官方Docker SDK实现100% Docker功能

部署与示例

使用Docker部署

可通过命令行快速使用Docker运行Isaiah：

sh
# 创建.env文件
touch .env

# 编辑.env文件...

# 选项1：附加到终端运行（调试用）
docker run \
  --env-file .env \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -p <你的端口映射> \
  docker.xuanyuan.run/mosswill/isaiah

# 选项2：作为守护进程运行
docker run \
  -d \
  --env-file .env \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -p <你的端口映射> \
  docker.xuanyuan.run/mosswill/isaiah

# 选项3：使用默认设置快速运行
docker run -v /var/run/docker.sock:/var/run/docker.sock:ro -p 3000:3000 docker.xuanyuan.run/mosswill/isaiah

使用Docker Compose部署

"examples/"目录中提供了多个示例docker-compose文件，包括：

• docker-compose.simple.yml：在80端口运行Isaiah，环境变量直接在compose文件中设置
• docker-compose.volume.yml：在80端口运行，通过卷挂载.env文件提供环境变量
• docker-compose.ssl.yml：在443端口运行HTTPS，通过卷挂载证书和私钥
• docker-compose.proxy.yml：在80端口运行，前端有443端口代理
• docker-compose.traefik.yml：在80端口运行，使用Traefik作为443端口代理

使用方法：

sh
# 选项1：在当前终端运行（调试用）
docker-compose up

# 选项2：后台运行（常用）
docker-compose up -d

# 查看日志（调试用）
docker logs <容器名称>

警告：确保挂载Docker Unix套接字，否则Isaiah无法与Docker API通信。

独立部署

可通过下载预编译二进制文件或手动构建来部署Isaiah。

使用预编译二进制

通过单行命令安装：

sh
curl https://raw.githubusercontent.com/will-moss/isaiah/master/scripts/remote-install.sh | bash

安装后运行：

sh
# 创建.env文件
touch .env

# 编辑.env文件...

# 启动Isaiah
isaiah

手动构建二进制

前置要求：

• Go 1.21
• Node 20+及npm、npx

构建步骤：

sh
# 获取代码
git clone https://github.com/will-moss/isaiah
cd isaiah

# 运行本地安装脚本
./scripts/local-install.sh

# 创建配置目录并运行
cd ~
mkdir isaiah-config
cd isaiah-config
touch .env
# 编辑.env文件...
isaiah

安装脚本会执行CSS/JS资源处理、Go代码编译、清理 artifacts 并将可执行文件移动到/usr/bin。

配置

需在可执行文件旁的.env文件中设置以下环境变量（命令行环境变量也可）：

注意：布尔值不区分大小写，可使用"ON"/"OFF"/"TRUE"/"FALSE"/0/1。

主题定制

可通过custom.css文件自定义Web界面样式，Isaiah会在可执行文件旁查找该文件并加载。Docker部署时需挂载该文件：-v my-custom.css:/custom.css。

CSS颜色变量说明

故障排除

Isaiah无法通过HTTP/HTTPS访问

• 独立部署：检查防火墙端口开放、DNS配置、.env配置
• Docker部署：除上述检查外，确保挂载docker.sock、容器网络可达
• 代理部署：检查代理转发规则和SERVER_PORT配置

模拟shell行为异常或显示乱码

shell通过Websocket捕获标准输出/错误并绑定标准输入实现，远程终端不接收按键事件，仅接收命令。

远程连接随机断开或重启

通常因Websocket消息超过最大接收大小，可增大SERVER_MAX_READ_SIZE（默认1024字节）。

无法点击或使用键盘

右下角橙色警告图标表示连接丢失，此时所有输入被禁用，连接会每秒重试。

shell启动失败

可修改TTY_SERVER_COMMAND（服务器shell）或TTY_CONTAINER_COMMAND（容器shell）命令。

安全注意事项

• 始终启用认证（设置AUTHENTICATION_ENABLED和AUTHENTICATION_SECRET），除非通过代理实现认证
• 使用长且安全的密码
• 考虑将Isaiah部署在仅通过***访问的私有网络

任何安全漏洞或配置错误可能导致服务器被完全控制。

免责声明

• Isaiah并非lazydocker的竞争对手或替代品，作者本人更习惯通过SSH使用lazydocker
• Isaiah从零构建，参考了lazydocker的部分设计（如容器状态和图标）
• 尝试过"通过Websocket提供lazydocker"但未成功，因此完全重写

贡献

欢迎通过以下方面贡献：

• 术语规范
• 编码实践改进
• shell模拟优化
• 发布流程优化
• Github设置优化

致谢

感谢以下项目和团队：

• https://github.com/jesseduffield/lazydocker%EF%BC%9AIsaiah%E7%9A%84%E7%81%B5%E6%84%9F%E6%9D%A5%E6%BA%90
• https://github.com/tailwindlabs/heroicons%EF%BC%9A%E5%9B%BE%E6%A0%87%E8%B5%84%E6%BA%90
• https://github.com/olahol/melody%EF%BC%9AGo Websocket实现
• https://github.com/goreleaser/goreleaser%EF%BC%9A%E5%8F%91%E5%B8%83%E5%B7%A5%E5%85%B7