3x-ui/docs/Tasktracking/2026-04-22-fix-panel-port-input-flow.md

Task Record:

Date: 2026-04-22 Related Module: install script (install.sh) Change Type: Fix

Background

The panel port setup in fresh install used a y/n confirmation before reading the port. When users directly entered a numeric port like 443 at the confirmation prompt, it was treated as non-y and the script generated a random port, causing unexpected behavior.

Changes

Replaced the two-step y/n + port input flow with a single direct input flow in install.sh. Now the script asks for panel port directly:

• Empty input: generate random panel port.
• Valid numeric port (1-65535): use as panel port.
• Invalid input: show error and prompt again.

Added tests/panel_port_prompt_test.sh to verify the expected prompt and validation logic exists and the legacy y/n prompt is removed.

Impact

Affected files:

• install.sh
• tests/panel_port_prompt_test.sh

No API, database schema, or build pipeline changes. Runtime install interaction is changed for fresh install panel-port setup only.

Verification

Commands:

• bash tests/panel_port_prompt_test.sh
• bash tests/mariadb_install_switch_test.sh

Result:

• Both scripts passed.

Risks And Follow-Up

Current verification is static prompt/logic assertion, not full interactive E2E install simulation. If needed, add an automated pty-based interaction test to validate runtime behavior across shells.