User Scanner
User Scanner 部署:隔离模块、代理、报告和 MCP
覆盖 Python 依赖、出站访问、代理验证、报告存储和受控 MCP。

你将学会
- Explain module, pivot, report, and MCP layers
- Run a bounded scan and interpret uncertainty
- Apply authorization, rate-limit, and data-retention controls
开始前需要
- Basic Git and command-line usage
- Comfort reading a project README
You can explain the project, run its documented first step, and decide what to verify before adopting it.
先看结论
- Pin Python/package versions and isolate scanner data and credentials.
- Use allow-listed outbound access, bounded proxies, and local/trusted MCP.
- Protect reports with encryption, retention, metadata, monitoring, and recovery tests.
Pin the runtime and package
在隔离环境固定 Python/package 版本,限制域名、并发、代理和 MCP;报告加密、脱敏并设定留存,测试超时、部分导出、清理和恢复。
Keep the scanner separate from production credentials and personal datasets. A clean environment makes upgrades and removals testable.
Control outbound access
Allow-list public domains required by the selected modules, set request timeouts and concurrency, and validate proxies before use. Proxy rotation is a routing choice, not a permission bypass; honor provider terms and stop on blocks or consent boundaries.
Keep MCP on stdio or a trusted local boundary. Do not expose a scanner server to an untrusted network or let a client inject arbitrary proxy files, output paths, or recursive depth.
Store reports safely
Write JSON/CSV/PDF reports to an access-controlled directory, encrypt at rest, and retain only fields needed for the purpose. Include target hash or normalized identifier, module set, timestamp, software version, proxy mode, and reviewer decision without storing secrets.
Test a dry run, a module timeout, a proxy failure, a partial report, and cleanup. A process exit of zero does not prove every platform response was available or accurate.
Operate and recover
Monitor request errors, rate limits, latency, output size, pivot depth, and storage. If credentials, reports, or a proxy are exposed, stop scans, revoke access, quarantine outputs, restore a known-good environment, and document deletion or notification.
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
Create an isolated pinned runtime and review module provenance.
- 2
Define domains, timeouts, concurrency, proxy, and MCP boundaries.
- 3
Run smoke/failure tests and store redacted reports securely.
- 4
Monitor, rotate, quarantine, restore, and verify cleanup.
可复制示例
python3 -m venv .venv
. .venv/bin/activate
pip install "user-scanner[mcp]"
user-scanner -u owned-handle -P proxies.txt --validate-proxies -f json -o reports/run.json
user-scanner-mcp常见问题
Can I expose user-scanner-mcp on the public internet?
Do not do so by default; keep it local or behind a trusted, authenticated boundary with explicit scope.
How should proxy credentials be stored?
Use an OS secret store or managed secret provider; never commit them or include them in reports.
资料来源
- User Scanner README (captured 2026-08-31)来源核查 2026-08-31
- User Scanner repository来源核查 2026-08-31