先装，然后记住 aegisx 这一个命令就够了——日常所有操作都在它的数字菜单里。
官方一键脚本：自动下载二进制（SHA256 完整性校验）→ 安装到 /usr/local/bin/aegisx → 初始化配置目录 → 安装 nftables → 注册并启动 systemd 服务，全程无交互，结束后面板地址、用户名、初始密码直接打印在屏幕上。必须以 root 运行。
$curl -fsSL https://www.aegisx.cn/install.sh | bash
💡root 用户直接执行；普通用户用 curl -fsSL https://www.aegisx.cn/install.sh | sudo bash。仅支持 x86_64，兼容 glibc 2.17+（CentOS 7 / Ubuntu 16+ / Debian 9+ 等全版本）。
已有授权码时，把授权码作为参数传给安装脚本，装完自动激活，直接获得对应套餐权限，无需安装后再手动激活。
$curl -fsSL https://www.aegisx.cn/install.sh | bash -s -- XS-XXXX-XXXX-XXXX-XXXX
XS-XXXX-… 你的授权码（1 台服务器 1 个码）
必记aegisx · 打开管理菜单（新手唯一要记的命令）
这是你唯一需要记住的命令。SSH 登录后直接输入 aegisx 回车，即弹出 22 项中文数字菜单：[1] 安装信息、[3] 面板地址、[5] 重置密码、[6] 改端口、[13] 修复面板、[21] 紧急修复、[15] 封禁 IP、[22] 卸载……全程不用记参数，输个数字就行。
$aegisx
💡root 用户直接输 aegisx 即可；非 root 用户输 sudo aegisx（写全 aegisx menu 也等价，但没必要）。菜单需在真正的 SSH 终端运行；网页终端 / 管道环境会自动切换为命令提示模式，直接输具体子命令即可。
安装aegisx install · 初始化并注册服务
创建配置/日志/隔离目录、生成初始配置与面板账号、写入并启用 aegisx.service。正常情况下一键安装脚本已自动执行，仅在你是手动放置二进制、或服务单元丢失需要重新注册时才需要手动跑。
$sudo aegisx install
先看状态再动手——这几条命令只读不修改，任何时候都可以放心执行。
自动探测本机公网 IP，打印面板完整访问地址、用户名、初始密码提示、面板端口、机器指纹、授权状态（套餐/到期/服务器 ID）、systemd 单元状态和常用命令清单。装完随时可再看，是排查「面板在哪、密码是啥」的第一命令。不想记参数？直接 aegisx 进菜单选 [1] 效果一样。
$aegisx info
只读aegisx status · 运行状态与授权信息
显示服务是否已安装/正在运行、当前版本、授权状态与到期时间等。做监控巡检或怀疑防护没在跑时先执行它。
$sudo aegisx status
诊断aegisx top · 揪出是谁在吃 CPU
一屏展示 aegisx 每个后台线程的实时 CPU、累计 CPU、读取字节数和正在打开的文件类型，区分是全盘查杀、防篡改自检、指标采集还是其他任务在忙。遇到「面板卡 / CPU 高」时执行它，几秒定位元凶，而不用盲猜。
$sudo aegisx top
只读aegisx geoip <IP> · 查询 IP 归属地
基于内置离线 GeoIP 库，输出某个 IP 的国家/地区与展示文本，面板里攻击源归属地显示用的就是同一套数据。
$sudo aegisx geoip 8.8.8.8
任何子命令后加 --help 可查看该命令的参数说明；全局加 -v 输出 debug 级详细日志（等同 RUST_LOG=debug），排查疑难问题时用。
$aegisx --version
$aegisx --help
$sudo aegisx -v scan --path /var/www
忘记密码、端口冲突、想换隐蔽访问路径——全部一条命令搞定，改完即时生效。
输出面板访问 URL（含随机安全路径前缀）、用户名、密码状态，以及重置密码/换端口/换路径的命令提示。
$sudo aegisx panel show
忘记面板密码时执行：立即生成一个新随机密码并打印（只显示这一次，请立刻保存），用户名不变。面板鉴权每次请求实时读取配置，无需重启服务，新密码立刻可用。
$sudo aegisx panel reset
面板panel reset-user · 重置随机用户名
将面板用户名重置为随机 12 位字符串（弱用户名自愈，防止用户名被猜到后爆破），密码保持不变，即刻生效。
$sudo aegisx panel reset-user
面板panel change-port · 修改面板端口
把面板监听端口改为指定值并自动重启服务。当原端口被其他程序占用、或想换一个更隐蔽的端口时使用。取值范围 1024–65535，官方推荐 30000–40000 区间。
$sudo aegisx panel change-port --port 38080
--port <端口> 必填，1024–65535，推荐 30000–40000
⚠️改完端口后，务必到云厂商控制台的安全组 / 防火墙放行新端口的 TCP 入站，否则外网将打不开面板。
面板panel rotate-prefix · 轮换 URL 安全路径
把面板地址中的随机路径前缀换成一个新的（如 http://IP:端口/x7k9…/），让扫描器和爬虫找不到你的面板入口。换完需重启服务生效。
$sudo aegisx panel rotate-prefix
$sudo systemctl restart aegisx
💡面板是 HTTP 不是 HTTPS，浏览器地址栏请输入 http:// 开头，别写成 https，否则会打不开。
AegisX 守护进程以 systemd 服务 aegisx.service 运行，用标准的 systemctl / journalctl 管理，和管理 nginx、mysql 完全一样。
启动守护进程，面板、WAF、CC 防护、监控自检等全部功能随之运行。
$sudo systemctl start aegisx
临时停止全部防护与面板。只是本次停止，重启服务器后若服务已 enable 仍会自动拉起；如需彻底停用请配合 disable。
$sudo systemctl stop aegisx
修改端口、路径或面板异常时最常用的一条；服务内置崩溃自动拉起，但手动重启能让所有配置干净重载。
$sudo systemctl restart aegisx
查看服务是否 active/running、进程 PID、内存占用与最近几行日志，确认服务真实状态（不依赖面板缓存）。
$systemctl status aegisx
安装后默认已开机自启。需要迁移、临时下线时可 disable；恢复防护时重新 enable 即可。
$sudo systemctl enable aegisx
$sudo systemctl disable aegisx
持续滚动输出 AegisX 实时日志，攻击拦截、封禁动作、自检与报错都在这里面滚动出现，按 Ctrl+C 退出。排查「刚刚发生了什么」的第一命令。
$journalctl -u aegisx -f
不持续跟踪，只打印最近 100 行（--no-pager 直接全部输出不分页），适合在网页终端或复制给客服排查时使用。
$journalctl -u aegisx -n 100 --no-pager
所有升级包都经过 Ed25519 签名 + SHA256 双校验，配置、授权、网站与数据库数据始终保留。
升级update --check · 只检查不升级
对比中控站最新版本与本机版本，只报告有没有新版本、版本号是多少，不做任何改动。适合先观望再决定。
$sudo aegisx update --check
检测到新版本后显示版本对比，并询问 y/N，确认后下载、校验签名与 SHA256、热替换正在运行的二进制并重启服务。
$sudo aegisx update
升级update --yes · 跳过询问直接升级
跳过 y/N 确认步骤，适合写进脚本、定时任务或通过 ansible/批量运维通道对多台机器统一升级。
$sudo aegisx update --yes
修复update --force --yes · 一键修复面板
即使版本号相同也强制重新下载覆盖程序文件，并修复 systemd 服务单元后重启。面板白屏、打不开、文件损坏、升级异常时的「万能修复」，网站文件、数据库、站点配置、授权信息全部原样保留。
$sudo aegisx update --force --yes
💡这也是交互菜单中「[13] 修复面板」底层实际执行的命令。
手动指定升级包所在的基地址（默认自动使用中控站地址），用于专属节点、测试通道或自定义镜像源。
$sudo aegisx update --url https://your-mirror.example.com --yes
完全使用系统 curl 下载（带 5 次重试、绝不写入空文件），绕开内置下载器，专治内置升级反复失败、下载空文件、进度卡死等问题。自动校验非空与 SHA256，然后替换二进制并重启。
$curl -fsSL https://www.aegisx.cn/agent/emergency_upgrade.sh | bash
立即向中控站发起一次授权续期。正常情况下 Agent 每隔 6 小时自动续签，一般无需手动执行；仅在授权状态显示异常、刚完成续费想立即生效时使用。
$sudo aegisx renew
立即触发一次 Bootstrap 同步：从 GitHub / Gitee / 阿里 OSS 三个签名源拉取最新的中控 endpoints 配置（验签通过后才接受）。中控站切换节点、域名解析变更后可用它立即刷新，无需等待每天一次的自动同步。
$sudo aegisx sync
🛡️
Security Operations
安全运维
手动封禁/解封 IP、管理白名单、Webshell 扫描查杀——自动防护之外的人工补刀手段。
封禁aegisx ban <IP> · 封禁攻击 IP
通过 nftables 立即封禁指定 IP 的所有入站流量，默认封禁 24 小时，到期自动解封；封禁记录持久化，服务重启后仍会恢复。
$sudo aegisx ban 1.2.3.4
用 --duration 控制封禁时长，支持 1h（1 小时）、24h（1 天，默认）、7d（7 天）、permanent（永久）。
$sudo aegisx ban 1.2.3.4 --duration 7d
$sudo aegisx ban 1.2.3.4 --duration permanent
1h 1 小时24h 默认
7d 7 天permanent 永久
解封aegisx unban <IP> · 立即解封
移除指定 IP 的动态封禁规则并清除到期记录，立即恢复访问。误封正常访客、或需要提前放行时使用。
$sudo aegisx unban 1.2.3.4
查询aegisx banned · 查看当前封禁列表
列出所有正在封禁的 IP 及各自剩余时间（永久封禁单独标注）。无需 root 也可查看。
$aegisx banned
白名单whitelist add · 加入白名单（永不封禁）
把指定 IP 或 CIDR 网段加入白名单，任何风控规则都不会封它。强烈建议先把自己的办公网 IP、运维跳板机、公司 NAT 出口加进去。支持单 IP 和 CIDR（如 10.0.0.0/8）。
$sudo aegisx whitelist add 1.2.3.4
$sudo aegisx whitelist add 1.2.3.0/24
白名单whitelist remove · 移出白名单
把某个 IP / CIDR 从白名单移除，移除后该地址重新接受所有风控规则检测。
$sudo aegisx whitelist remove 1.2.3.4
白名单whitelist list · 查看白名单
列出当前全部手工白名单条目（中控站 IP 与内网地址另有内置保护，不在此列表中）。
$aegisx whitelist list
白名单whitelist myself · 一键保护自己
自动探测本机当前的公网出口 IP 并加入白名单。上服务器做任何封禁/防护测试前先跑一次，避免自己的 IP 触发 CC 防护后被锁死在面板外面。
$sudo aegisx whitelist myself
查杀aegisx scan · Webshell 手动扫描
对网站目录做 Webshell 静态检测 + 多维威胁打分，默认扫描 /var/www，输出命中文件、风险等级与评分，默认只报告不删除。
$sudo aegisx scan
用 -p 或 --path 指定任意目录。网站不在默认目录、挂载了数据盘、或只想检查某个站点时使用。
$sudo aegisx scan --path /data/www/wwwroot
-p, --path <路径> 默认 /var/www
查杀scan --quarantine · 命中后自动隔离
扫描同时把命中的高危/极危文件自动移入系统隔离区，使其无法被 Web 访问或执行，同时保留样本供回溯，不会直接删除；可在面板「隔离区」中统一查看与处置。
$sudo aegisx scan --path /var/www --quarantine
⚠️隔离会移动文件，极少数情况下可能影响结构特殊的业务站点，建议先不带 --quarantine 扫一遍确认命中清单，再决定是否隔离。
安装后自动获得 24 小时 SVIP 全功能试用；到期后用授权码激活，1 台服务器对应 1 个授权码。
授权aegisx activate · 使用授权码激活
把购买的授权码绑定到本机，成功后立即解锁对应套餐（VIP/SVIP）的全部能力，授权凭证由中控站签名签发并加密保存在本机，到期前 Agent 会自动续签。
$sudo aegisx activate --code XS-XXXX-XXXX-XXXX-XXXX
-c, --code 授权码，形如 XS-XXXX-XXXX-XXXX-XXXX
授权activate --url · 指定中控站激活
正常情况下无需此参数（自动走配置中的中控站地址）。仅当专属部署、迁移节点需要向指定中控站发起激活时使用。
$sudo aegisx activate --code XS-XXXX-XXXX-XXXX-XXXX --url https://www.aegisx.cn
以前台方式运行守护主进程，是 systemd 单元 ExecStart=/usr/local/bin/aegisx daemon 调用的内部命令，普通用户不需要手动执行（手动跑会与 systemd 管理的实例冲突，程序会自动清理残留进程）。服务启停请一律使用 systemctl。
$# 仅供了解，请勿手动运行 —— 请用 sudo systemctl start aegisx
会移除程序与服务；请确认后再执行，建议卸载前先在面板里确认业务无依赖。
危险aegisx uninstall · 卸载 Agent
停止并禁用 aegisx 服务、删除 systemd 单元与二进制，并清理配置目录；隔离区文件默认保留，避免误删还需分析的样本。卸载后所有防护立即失效。
$sudo aegisx uninstall
危险uninstall --purge · 连数据一起彻底清除
在卸载基础上，额外清空全部本地数据与隔离区，适合服务器退役或确定不再使用 AegisX 的场景。执行前请确认不再需要隔离样本与本地数据。
$sudo aegisx uninstall --purge
🚨危险操作：配置、授权、面板账号、隔离样本将全部删除且不可恢复。交互菜单中卸载还需输入 YES 二次确认。
🚑
Emergency Playbook
故障应急速查
出问题别慌——按「症状」找到对应命令，复制执行即可。每条都来自真实修复流程。
重置为随机新密码，终端会直接打印新密码，用原用户名登录即可，无需重启。
$sudo aegisx panel reset
先执行 info 拿到真实端口与地址；绝大多数「打不开」都是云安全组没放行。先查服务，再换一个端口（别忘了去安全组放行新端口的 TCP 入站）。
$sudo aegisx info
$systemctl status aegisx
$sudo aegisx panel change-port --port 38080 && sudo systemctl restart aegisx
强制重装最新程序文件并修复服务单元，配置与数据全部保留，这是覆盖面最广的一条自愈命令。
$sudo aegisx update --force --yes
先温和重启；若仍无响应，交互菜单里有「[21] 紧急修复 → [5] 强制重启服务」，会先清理残留进程再通过 systemd 拉起。
$sudo systemctl restart aegisx
$aegisx # 然后选 [21] → [5]
用 top 子命令看清是 AegisX 的哪个后台线程在忙（查杀扫描 / 自检 / 采集），再结合实时日志判断是否在跑大任务；AegisX 的重任务会自动 nice 让路业务，如持续偏高请把日志反馈给客服。
$sudo aegisx top
通过云厂商 VNC / 串口终端登录（绕过网络封禁），把自己加入白名单后解封当前 IP。预防：做防护测试前先 whitelist myself。
$sudo aegisx whitelist myself
走系统 curl 的紧急升级脚本，带重试和 SHA256 校验，绕开内置下载器的一切问题。
$curl -fsSL https://www.aegisx.cn/agent/emergency_upgrade.sh | bash
症状🧰 配置损坏 / 服务丢失 / 端口冲突，想一次修
交互菜单的「[21] 紧急修复」内置 7 项修复：重置密码、端口冲突、配置损坏（优先从自动备份恢复）、白屏、强制重启、重建 systemd 单元、一键全修复。进菜单选序号即可。
$aegisx # 选 [21] 紧急修复 → [7] 一键全修复
几条通用规则，知道这些就够了；配置、授权与日志均由 Agent 在系统受保护目录内自行管理，无需手工翻找。
🔑 权限
除 banned、whitelist list、info 等只读命令外，封禁、改端口、升级等写操作均需 root / sudo。
🧩 全局参数
-v, --verbose 输出 debug 详细日志（任意子命令前均可加）；--version 查版本；--help 查帮助。
💓 自动化节奏
心跳每 30 秒一次；授权每 6 小时自动续签；Bootstrap 配置每 24 小时自动同步；服务崩溃由 systemd 自动拉起。
🌐 面板协议
面板为 HTTP（非 HTTPS）；访问前确认云安全组已放行面板端口的 TCP 入站。
还没安装？一条命令开始守护
静态单文件 · SHA256 校验 · 30 秒装完，自动获得 24 小时 SVIP 全功能试用。