Nexus/docs/changelog/2026-06-01-files-sudo-hint.md

2026-06-01 文件管理 sudo 提示与白名单示例

日期

2026-06-01

变更摘要

区分「无免密 sudo / 白名单不全 / 已就绪」三种提示；sudoers 示例补充 bash（与 sudo -n bash -c 提权路径一致）。

动机

• 用户看到「部分操作将自动尝试 sudo」但操作仍失败：多为目标机未装 sudoers 或白名单缺少 bash
• 原示例未包含 bash，与 remote_shell.exec_ssh_command_with_fallback 行为不一致

涉及文件

• frontend/src/utils/fileMode.ts
• frontend/src/pages/FilesPage.vue
• docs/deploy/nexus-files-sudoers.example

迁移 / 重启

• 仅前端文案 + 文档；目标机需按新示例更新 /etc/sudoers.d/nexus-files 后无需重启 Nexus

验证方式

1. 非 root SSH + 无 sudo：文件页顶部红色提示，含「免密 sudo」与示例路径
2. 有 sudo -n true 但无 bash：黄色提示「白名单可能不完整」
3. 配置完整后：无多余横幅（除非目录内有不可读文件）