demers/butterfly

Butterfly 3.0

镜像概述

Butterfly是一个在浏览器中运行的Bash控制台工具，兼容Xterm标准，支持多种高级功能，可通过网页轻松访问终端服务。

核心功能

• Xterm兼容（支持大量未常用功能）
• 原生浏览器滚动与搜索
• CSS/Sass主题定制（含20种预设主题）
• 终端内HTML显示（如图片、表格）
• 多会话支持（多人同时访问同一终端）
• X509证书安全认证
• 1600万色支持
• 键盘文本选择
• 终端输出桌面通知
• 浏览器地理位置获取
• Firefox浏览器兼容

使用场景

• 远程服务器管理（通过网页访问终端）
• 团队协作终端（多人共享会话）
• 教学演示（网页端展示终端操作）
• 轻量级终端访问（无需本地终端软件）

配置说明

基础安装

bash
pip install butterfly
pip install butterfly[themes]  # 安装主题支持
pip install butterfly[systemd]  # 安装systemd支持
butterfly  # 启动服务，浏览器自动打开

作为服务器运行

bash
butterfly.server.py --host=myhost --port=57575  # 基础服务
butterfly.server.py --host=myhost --port=57575 --login  # 带登录验证
butterfly.server.py --host=myhost --port=57575 --login --pam_profile=sshd  # PAM认证（需root）

Systemd部署（Linux）

bash
cd /etc/systemd/system
curl -O https://raw.githubusercontent.com/paradoxxxzero/butterfly/master/butterfly.service
curl -O https://raw.githubusercontent.com/paradoxxxzero/butterfly/master/butterfly.socket
systemctl enable butterfly.socket
systemctl start butterfly.socket

需修改/etc/butterfly/butterfly.conf配置服务器参数。

Docker运行示例

• 带密码登录：

bash
docker run --env PASSWORD=password -d docker.xuanyuan.run/demers/butterfly --login

• 无密码访问：

bash
docker run -d -p 57575:57575 docker.xuanyuan.run/demers/butterfly

• 自定义端口：

bash
docker run -d -p 12345:12345 docker.xuanyuan.run/demers/butterfly --port=12345

许可证

本项目基于GNU General Public License v3.0开源。

butterfly Copyright (C) 2015-2017 Florian Mounier

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.