mirror of
https://github.com/MHSanaei/3x-ui.git
synced 2026-05-30 08:59:34 +00:00
Bug, feature, and question templates now collect the triage signal the maintainers usually have to ask for (install method, OS, area, reverse proxy, logs, version). config.yml disables blank issues and points to Wiki / existing issues / latest release from the picker. PR template adds Summary/Why/Type/Areas/Testing/Breaking-changes sections and a fuller checklist (build, tests, lint, typecheck, docs). Renamed pull_request_template.yml -> .md to match GitHub's conventional extension; the old .yml was being read as markdown anyway.
165 lines
4.5 KiB
YAML
165 lines
4.5 KiB
YAML
name: Bug report
|
|
description: Report something that is broken or behaving unexpectedly
|
|
title: "[Bug]: "
|
|
labels: ["bug", "needs triage"]
|
|
|
|
body:
|
|
- type: markdown
|
|
attributes:
|
|
value: |
|
|
Thanks for taking the time to file a bug. A complete report helps us
|
|
reproduce and fix it quickly. Please **search [existing issues](../issues?q=is%3Aissue)**
|
|
before opening a new one — duplicates will be closed.
|
|
|
|
- type: textarea
|
|
id: what-happened
|
|
attributes:
|
|
label: Describe the bug
|
|
description: A clear and concise description of what went wrong.
|
|
placeholder: When I … the panel does … but I expected it to …
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: how-repeat-problem
|
|
attributes:
|
|
label: How to reproduce the problem
|
|
description: Numbered steps starting from a clean state. The clearer the steps, the faster the fix.
|
|
placeholder: |
|
|
1. Open the `Inbounds` page
|
|
2. Create a new VLESS inbound with …
|
|
3. Click `Save`
|
|
4. Observe …
|
|
validations:
|
|
required: true
|
|
|
|
- type: textarea
|
|
id: expected-action
|
|
attributes:
|
|
label: Expected behavior
|
|
placeholder: I expected the panel to …
|
|
validations:
|
|
required: false
|
|
|
|
- type: textarea
|
|
id: received-action
|
|
attributes:
|
|
label: Actual behavior
|
|
placeholder: Instead, the panel …
|
|
validations:
|
|
required: false
|
|
|
|
- type: textarea
|
|
id: logs
|
|
attributes:
|
|
label: Relevant logs
|
|
description: |
|
|
Panel logs (`journalctl -u x-ui -n 200`) and/or the browser DevTools
|
|
console output. **Redact** tokens, real domains, IPs, and client UUIDs.
|
|
render: shell
|
|
validations:
|
|
required: false
|
|
|
|
- type: textarea
|
|
id: screenshots
|
|
attributes:
|
|
label: Screenshots
|
|
description: Drag images directly into this field. Redact any sensitive data.
|
|
validations:
|
|
required: false
|
|
|
|
- type: input
|
|
id: xui-version
|
|
attributes:
|
|
label: 3x-ui version
|
|
description: Shown at the top of the panel sidebar.
|
|
placeholder: 3.1.0
|
|
validations:
|
|
required: true
|
|
|
|
- type: input
|
|
id: xray-version
|
|
attributes:
|
|
label: Xray-core version
|
|
description: Visible on the `Xray Settings` page.
|
|
placeholder: 25.x.x
|
|
validations:
|
|
required: false
|
|
|
|
- type: dropdown
|
|
id: install-method
|
|
attributes:
|
|
label: How did you install 3x-ui?
|
|
options:
|
|
- install.sh script
|
|
- Docker / Docker Compose
|
|
- Manual build from source
|
|
- Other (please describe in the bug body)
|
|
validations:
|
|
required: true
|
|
|
|
- type: input
|
|
id: os
|
|
attributes:
|
|
label: Operating system
|
|
description: Distribution and version.
|
|
placeholder: Ubuntu 24.04 / Debian 12 / CentOS Stream 9 …
|
|
validations:
|
|
required: true
|
|
|
|
- type: dropdown
|
|
id: area
|
|
attributes:
|
|
label: Which parts of the panel are affected?
|
|
multiple: true
|
|
options:
|
|
- Frontend (UI / panel pages)
|
|
- Backend (API endpoints, login, settings)
|
|
- Xray config generation
|
|
- Subscription (share links / Clash / JSON)
|
|
- Statistics / traffic counters
|
|
- Database / migrations
|
|
- Install / upgrade script
|
|
- Docker image
|
|
- Multi-node (sub-nodes)
|
|
- Telegram bot
|
|
- Other
|
|
validations:
|
|
required: false
|
|
|
|
- type: input
|
|
id: browser
|
|
attributes:
|
|
label: Browser (only if it is a UI bug)
|
|
placeholder: Chrome 132 / Firefox 134 / Safari 18 / mobile Chrome …
|
|
validations:
|
|
required: false
|
|
|
|
- type: dropdown
|
|
id: reverse-proxy
|
|
attributes:
|
|
label: Is the panel behind a reverse proxy or CDN?
|
|
options:
|
|
- "No — direct access"
|
|
- "Yes — Nginx"
|
|
- "Yes — Caddy"
|
|
- "Yes — Cloudflare (proxied DNS)"
|
|
- "Yes — Cloudflare Tunnel"
|
|
- "Yes — other"
|
|
validations:
|
|
required: false
|
|
|
|
- type: checkboxes
|
|
id: checklist
|
|
attributes:
|
|
label: Before submitting
|
|
options:
|
|
- label: I searched [existing issues](../issues?q=is%3Aissue) and this bug has not been reported.
|
|
required: true
|
|
- label: I am running the latest released version of 3x-ui (or have verified the bug still exists on it).
|
|
required: true
|
|
- label: This bug report is written in English.
|
|
required: true
|
|
- label: I have redacted any sensitive data (tokens, real domains, client UUIDs).
|
|
required: true
|