# Surge Manual

## Overview
Surge is a web development and proxy utility. This repository contains the documentation for
its rules, policies, DNS, HTTP processing, scripting, and related configuration.

## Entry Points
- README.md: High-level overview and product capabilities.
- SUMMARY.md: Table of contents for all documentation sections.

## Core Documentation
- overview/components.md: Major components and how they fit together.
- overview/configuration.md: Profile/configuration structure.
- rule.md: Proxy rule overview.
- rule/domain-based.md: Domain-based rules.
- rule/ip-based.md: IP-based rules.
- rule/http.md: HTTP rules.
- rule/process.md: Process rules.
- rule/logical-rule.md: Logical rules.
- rule/subnet.md: Subnet expression and rules.
- rule/misc-rule.md: Miscellaneous rules.
- rule/ruleset.md: Ruleset definition and usage.
- rule/final.md: Final rule behavior.
- policy.md: Proxy policy overview.
- policy/built-in.md: Built-in policy types.
- policy/reject.md: REJECT policy.
- policy/proxy.md: Proxy policy definition.
- policy/wireguard.md: WireGuard policy.
- policy/ssh.md: SSH policy.
- policy/parameters.md: Common policy parameters.
- policy/external-proxy.md: External proxy program.
- policy-group/group.md: Policy group overview.
- policy-group/select.md: Manual selection group.
- policy-group/url-test.md: Automatic testing group.
- policy-group/fallback.md: Fallback group.
- policy-group/subnet.md: Subnet group.
- policy-group/load-balance.md: Load balance group.
- policy-group/policy-including.md: Policy including.
- policy-group/common-parameters.md: Common group parameters.
- dns/dns-override.md: DNS server configuration.
- dns/local-dns-mapping.md: Local DNS mapping.
- dns/doh.md: Encrypted DNS.
- http-processing.md: HTTP processing overview.
- http-processing/mitm.md: HTTPS decryption (MITM).
- http-processing/url-rewrite.md: URL rewrite.
- http-processing/header-rewrite.md: Header rewrite.
- http-processing/body-rewrite.md: Body rewrite.
- http-processing/mock.md: Mock (map local).
- scripting/common.md: Scripting basics.
- scripting/http-request.md: HTTP request scripting.
- scripting/http-response.md: HTTP response scripting.
- scripting/rule.md: Rule scripting.
- scripting/event.md: Event scripting.
- scripting/dns.md: DNS scripting.
- scripting/cron.md: Cron scripting.
- others/misc-options.md: Misc options.
- others/managed-profile.md: Managed profile.
- others/enhanced-mode.md: Enhanced mode.
- others/subnet-settings.md: Subnet settings.
- others/host-list.md: Host list parameter type.
- others/url-scheme.md: URL scheme.
- others/module.md: Module.
- others/http-api.md: HTTP API.
- others/panel.md: Information panel.
- others/port-forwarding.md: Port forwarding.
- others/cli.md: Surge Mac CLI.