easynode

<div align="center">

# EasyNode

_✨ 一个多功能Linux服务器终端面板(webSSH&webSFTP) ✨_

</div>

<p align="center">
  <a href="https://github.com/chaos-zhu/easynode/releases/latest">
    <img src="https://img.shields.io/github/v/release/chaos-zhu/easynode?color=brightgreen" alt="release">
  </a>
  <a href="https://github.com/chaos-zhu/easynode/actions">
    <img src="https://img.shields.io/github/actions/workflow/status/chaos-zhu/easynode/docker-builder.yml?branch=main" alt="deployment status">
  </a>
  <a href="https://hub.docker.com/repository/docker/chaoszhu/easynode">
    <img src="https://img.shields.io/docker/pulls/chaoszhu/easynode?color=brightgreen" alt="docker pull">
  </a>
  <a href="https://github.com/chaos-zhu/easynode/releases/latest">
    <img src="https://img.shields.io/github/downloads/chaos-zhu/easynode/total?color=brightgreen&include_prereleases" alt="release">
  </a>
</p>

<p align="center">
  <a href="#功能">功能</a>
  ·
  <a href="#面板展示">面板展示</a>
  ·
  <a href="#移动端展示">移动端展示</a>
  ·
  <a href="#项目部署">项目部署</a>
  ·
  <a href="#监控服务安装">监控服务安装</a>
  ·
  <a href="#建议">建议</a>
  ·
  <a href="#声明">声明</a>
  ·
  <a href="#常见问题">常见问题</a>
</p>

## 功能

+ [x] 功能完善的**SSH终端**&**SFTP**
+ [x] AI agent组件 🤖
+ [x] 批量导入、导出、编辑服务器配置、脚本等
+ [x] 脚本库
+ [x] 实例分组
+ [x] 凭据托管
+ [x] 多渠道通知
+ [x] 批量下发指令
+ [x] 自定义终端主题
+ [x] Native移动端，支持iOS / Android原生SSH、SFTP、Docker、脚本库等能力

## 面板展示

![面板展示](./doc_images/merge.gif)

## 移动端展示

Native端复用现有EasyNode后端，在移动设备上提供服务器管理、原生SSH终端、SFTP文件管理、Docker、脚本库和服务器状态等能力。

<p align="center">
  <img src="./doc_images/terminal3.png" alt="Native端SSH终端、SFTP和服务器状态展示" width="900">
</p>

## 项目部署

### 默认账号与密码查看

- 首次启动后会在终端自动生成管理员账号密码，登录后请及时修改，避免日志残留敏感信息。
- 请牢记账号密码；Docker 部署如需重置密码，可使用下方的维护脚本。
- 访问：
  - https安全访问：https://ip:8092  【注意：默认启用https自签证书加密访问，首次打开需在浏览器中手动跳过 https 证书错误提示：浏览器页面中点 高级 --> 继续前往】
  - http 内网访问：http://ip:8082  【切记：公网访问**请勿使用http**】

### docker-compose部署

> 部署本项目的 [docker-compose.yml](https://github.com/chaos-zhu/easynode/blob/main/docker-compose.yml) 默认采用[腾讯云CNB自动构建镜像](https://cnb.cool/chaoszhu/easynode)，大陆服务器可直接部署使用。

- **使用仓库提供的docker-compose.yml部署即可自动升级EasyNode，免去再额外登录其他终端软件烦恼，以及第一时间收到底层组件的安全更新。**

```shell
# docker compose快速部署

# 1. 创建easynode目录
mkdir -p /root/easynode && cd /root/easynode

# 2. 下载docker-compose.yml文件（含watchtower自动更新）
wget https://git.221022.xyz/https://raw.githubusercontent.com/chaos-zhu/easynode/main/docker-compose.yml

# 3. 启动服务
docker compose up -d
```

<details>
<summary><strong>Docker 维护脚本</strong></summary>

<br>

以下脚本仅支持 Docker Compose 部署。请在 `docker-compose.yml` 所在目录执行，并严格按照“停止服务 → 运行一次性维护容器 → 恢复服务”的顺序操作，避免多个进程同时写入数据库。

> [!WARNING]
> 执行任何维护脚本前，必须先使用 `docker compose stop easynode` 完全停止 EasyNode 主容器。禁止通过 `docker exec` 在运行中的容器内执行这些脚本，否则多个进程同时写入 NeDB，可能造成数据覆盖或数据库损坏。

#### 重置管理员用户名和密码

```shell
docker compose stop easynode
docker compose run --rm --no-deps easynode node scripts/reset-password.js
docker compose