Skip to content

doc: Introduce the use of Nuclei XEC on qemu#59

Open
muxiff wants to merge 1 commit intoNuclei-Software:masterfrom
muxiff:master
Open

doc: Introduce the use of Nuclei XEC on qemu#59
muxiff wants to merge 1 commit intoNuclei-Software:masterfrom
muxiff:master

Conversation

@muxiff
Copy link
Copy Markdown
Contributor

@muxiff muxiff commented Nov 25, 2025

Important

Introduces documentation for using Nuclei XEC Ethernet on QEMU, detailing User and TAP network modes with setup instructions for Linux and Windows.

  • Documentation:
    • Adds nuclei_xec.rst to document using Nuclei XEC Ethernet on QEMU.
    • Updates index.rst to include nuclei_xec.rst in the table of contents.
  • Network Modes:
    • Describes User mode using Slirp library for NAT forwarding without root, with constraints like low throughput and no ICMP support.
    • Details TAP mode for high-performance networking, requiring root and manual configuration.
  • Configuration:
    • Provides Linux setup for TAP mode, including IP forwarding and TAP device creation.
    • Provides Windows setup for TAP mode, including driver installation and NAT/firewall rules.

This description was created by Ellipsis for 7e0a7e3. You can customize this summary. It will automatically update as commits are pushed.

@muxiff muxiff requested a review from fanghuaqi November 25, 2025 01:57
Copy link
Copy Markdown
Contributor

@ellipsis-dev ellipsis-dev Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Changes requested ❌

Reviewed everything up to 7e0a7e3 in 1 minute and 54 seconds. Click for details.
  • Reviewed 148 lines of code in 2 files
  • Skipped 0 files when reviewing.
  • Skipped posting 3 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.
1. source/qemu/nuclei_xec.rst:132
  • Draft comment:
    File is missing a trailing newline (EOF).
  • Reason this comment was not posted:
    Comment did not seem useful. Confidence is useful = 0% <= threshold 50% This comment is purely informative and does not provide any actionable feedback or suggestions for improvement. It simply points out a missing newline at the end of the file, which is a minor formatting issue that does not affect functionality.
2. source/qemu/nuclei_xec.rst:6
  • Draft comment:
    Typo: 'net work' in the text appears to have a space and should likely be 'network'.
  • Reason this comment was not posted:
    Marked as duplicate.
3. source/qemu/nuclei_xec.rst:130
  • Draft comment:
    Typo: 'QMEU运行' appears to be a misspelling. It should be 'QEMU运行'.
  • Reason this comment was not posted:
    Marked as duplicate.

Workflow ID: wflow_SVT1uSJhrMOGkWeL

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Comment thread source/qemu/nuclei_xec.rst Outdated
QEMU9.0上XEC以太网使用指南
==========================

QEMU官方关于net work的文档: https://wiki.qemu.org/Documentation/Networking
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: Consider replacing 'net work' with 'network' for consistency.

Suggested change
QEMU官方关于net work的文档: https://wiki.qemu.org/Documentation/Networking
QEMU官方关于network的文档: https://wiki.qemu.org/Documentation/Networking

Comment thread source/qemu/nuclei_xec.rst Outdated
# 创建出站规则允许所有流量
$ New-NetFirewallRule -DisplayName "Allow All Outbound" -Direction Outbound -Action Allow

**QMEU运行**
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo: 'QMEU运行' should be 'QEMU运行'.

Suggested change
**QMEU运行**
**QEMU运行**

@fanghuaqi
Copy link
Copy Markdown
Member

暂不合入,这个是开发中的特性,需要文档上标注下,这个是2025.10以后的下个版本的特性,然后需要提醒用户默认情况下,建议使用 user mode, 这个不需要管理员权限配置网络,也能满足绝大多数需求。

@fanghuaqi
Copy link
Copy Markdown
Member

后续 @muxiff 需要补充一下Linux SDK dts需要修改的点,以及启动Linux以后怎么使用一些网络相关的命令便于测试。

@fanghuaqi
Copy link
Copy Markdown
Member

等待2026.06正式发布版本的时候合入

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants