登录与认证

浏览器通过本地管理员账号密码登录，服务端签发 HttpOnly 会话 Cookie。

首次使用时先注册管理员账号。AGENT_TOKEN 仅用于节点接入、外部校验和签名下载。

界面定位

当前页面默认管理本机节点，首页展示当前节点的资源、文件、接入、节点目录和日志。

远程节点以目录登记和切换查看为主，文档页用于集中承载说明性信息。

文件工作区

双击目录进入，单击条目后再执行上传、重命名、下载或删除操作。

列表同时展示名称、类型、权限、大小和修改时间，便于快速确认当前条目。

文件浏览模式

工作区模式受 AGENT_ROOT 目录边界限制，适合日常文件管理。

系统只读模式仅允许列目录和下载文件，不允许上传、删除、重命名或新建目录。

接入与域名

提交域名前请确认 A/AAAA 记录已经指向当前服务器，并且 nginx 可以监听 80/443。

接入页展示当前监听、目标监听、外部入口以及 HTTPS 相关状态。

运行配置

运行配置持久化保存在 SQLite 中，修改后按需重启服务生效。

AGENT_ROOT 会限制文件工作区边界，Agent Token 不再作为浏览器登录凭据。

节点与 WireGuard

节点目录用于登记远程节点 URL、WireGuard 地址和节点 Token。

install_agent_only.sh 只安装 agent 和 wireguard-tools；要拿到 WireGuard IP，还需要继续运行 sudo file-panel setup-agent 或 sudo file-panel bootstrap-wireguard ...。

引导与更新

WireGuard 引导支持一次性命令生成，也支持手动登记节点。

更新面板支持 quick、redeploy 和 full-install 三种模式。

日志与排查

日志页展示当前节点的 systemd 日志，可按级别过滤后查看运行问题。

资源页区分当前值、平滑值和趋势图，适合排查瞬时负载与长期趋势。

开发结构

app/ 保存 FastAPI 路由、服务和存储逻辑。

static/ 保存前端页面、样式和交互脚本，scripts/ 保存安装与控制脚本。

文档入口

仓库内还提供 README、USAGE、DEVELOPMENT、API、CONCEPTS、ARCHITECTURE 等文档文件。

前端文档页适合快速查阅界面说明，仓库文档更适合开发和接口调用。