[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-74926":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":38,"readmeContent":39,"aiSummary":40,"trendingCount":16,"starSnapshotCount":16,"syncStatus":15,"lastSyncTime":41,"discoverSource":42},74926,"MicroWARP","ccbkkb\u002FMicroWARP","ccbkkb","🚀 An 800KB RAM ultra-lightweight Cloudflare WARP SOCKS5 proxy in Docker. 仅需 800KB 内存的纯内核态 Cloudflare WARP 代理 - Docker","",null,"Shell",1240,161,3,2,0,10,40,120,30,104.63,"MIT License",false,"main",true,[27,28,29,30,31,32,33,34,35,36,37],"alpine","bypass-dpi","cloudflare","cloudflare-warp","docker","lightweight","proxy","socks5","warp","wireguard","zero-trust","2026-06-12 04:01:16","# MicroWARP 🚀\n\n[![Docker Pulls](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdocker-ready-blue.svg)](https:\u002F\u002Fgithub.com\u002Fccbkkb\u002FMicroWARP\u002Fpackages)\n[![License: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](https:\u002F\u002Fopensource.org\u002Flicenses\u002FMIT)\n\n> *请严格遵守您所在国家和地区的法律法规。任何因违法违规使用本项目而引发的法律纠纷或后果，均与本项目及作者无关。*\n> \n> *Please strictly comply with the laws and regulations of your country and region. Any legal disputes or consequences arising from illegal use of this project have nothing to do with this project and its authors.*\n\n[English](#english) |[中文说明](#chinese)\n\n### 📊 Performance Comparison\n\nHere is a real-world performance test on a 1C1G (1 vCPU, 1GB RAM) VPS, comparing MicroWARP with the widely used `caomingjun\u002Fwarp`.\n\n以下是在 1C1G 服务器上的真实运行数据截图对比：\n\n| Metric (指标) | `caomingjun\u002Fwarp` (Official Daemon) | 🚀 `MicroWARP` (Pure C + Kernel approach) | Improvement (提升) |\n| :--- | :--- | :--- | :--- |\n| **Image Size**\u003Cbr>(Docker 镜像体积) | 201 MB | **9.08 MB** | 📉 **-95%** |\n| **RAM Usage**\u003Cbr>(日常内存占用) | ~150 MB | **800 KiB** (\u003C 1MB) | 📉 **-99.4%** |\n| **CPU Overhead**\u003Cbr>(高并发 CPU 损耗) | High (Userspace App) | **~0.25%** (Kernel Space) | ⚡ **Near Zero** |\n| **Core Engine**\u003Cbr>(底层核心引擎) | Cloudflare `warp-cli` (Rust) | Linux `wg0` + Pure C `microsocks` | 🛠️ **Minimalist** |\n\n> **🔥 Real `docker stats` output:**\n> ```text\n> CONTAINER ID   NAME       CPU %     MEM USAGE \u002F LIMIT     MEM %     NET I\u002FO           BLOCK I\u002FO\n> 2fa58f84c517   warp       0.25%     800KiB \u002F 967.4MiB     0.08%     48.8MB \u002F 39.1MB   238kB \u002F 36.9kB\n> ```\n> *Yes, you read that right. It processed ~90MB of traffic using only **800 KB** of RAM!* *是的，你没看错。它仅使用了 **800 KB** 的内存，就处理了约 90 MB 的流量！*\n\n---\n\n\u003Ca name=\"english\">\u003C\u002Fa>\n## 🇬🇧 English\n\nA minimalist, high-performance Cloudflare WARP SOCKS5 proxy in Docker. \nDesigned as a lightweight drop-in replacement for standard WARP proxy images (e.g., `caomingjun\u002Fwarp`).\n\n### 🌟 Why MicroWARP?\n\nMany popular WARP Docker images rely on the official Cloudflare `warp-cli` daemon. This approach typically results in significant memory usage (often **150MB+**) and potential process overhead under high concurrency.\n\n**MicroWARP** is built differently:\n1. **Kernel-Level WireGuard**: Instead of the userspace client, it leverages the native Linux `wg0` interface for near-zero CPU overhead.\n2. **MicroSOCKS Engine**: Uses a pure C-based `microsocks` server to minimize resource consumption.\n3. **Minimal Memory Footprint**: Runs smoothly on **\u003C 5MB RAM** (often ~800KB). Highly optimized for resource-constrained environments (e.g., 1C1G VPS).\n4. **Seamless Tailscale Integration**: Natively resolves asymmetric routing blackholes, fully compatible with Tailnet inbound connections.\n5. **Multi-Arch**: Native support for `amd64` and `arm64`.\n\n### 🎯 Use Cases\n*   **API Routing**: Route crawlers or AI API gateways (like Grok, ChatGPT) through MicroWARP to leverage high-trust Cloudflare IPs.\n*   **Outbound Privacy**: Obfuscate your server's real IP by using WARP as your default egress network to prevent direct traceback.\n*   **Sidecar Proxy**: Perfectly designed as an ultra-lightweight Docker Sidecar network gateway.\n\n### 📦 Quick Start\n\nMap port `1080` and grant `NET_ADMIN` privileges. Create a `docker-compose.yml`:\n\n```yaml\nservices:\n  microwarp:\n    image: ghcr.io\u002Fccbkkb\u002Fmicrowarp:latest\n    container_name: microwarp\n    restart: always\n    ports:\n      - \"127.0.0.1:1080:1080\"\n    cap_add:\n      - NET_ADMIN\n      - SYS_MODULE\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      - warp-data:\u002Fetc\u002Fwireguard # Keep account data to avoid rate limits\n\nvolumes:\n  warp-data:\n```\n\nRun the container:\n```bash\ndocker compose up -d\n```\n\n### ⚙️ Advanced Configurations\n\nMicroWARP supports environment variables to customize your setup while keeping the memory footprint at 800KB:\n\n```yaml\n    environment:\n      - BIND_ADDR=0.0.0.0     # Bind address\n      - BIND_PORT=1080        # Custom SOCKS5 port\n      - SOCKS_USER=admin      # Enable authentication\n      - SOCKS_PASS=123456     # Auth password\n      \n      # ⚠️ Port Hopping (Mitigating Datacenter QoS):\n      # If your VPS is in a datacenter (e.g., DMIT, AWS) where UDP 2408 is throttled or blocked,\n      # use port 4500 (standard IPsec NAT-T) to bypass restrictive firewall rules.\n      - ENDPOINT_IP=162.159.192.1:4500 \n```\n\n---\n\n\u003Ca name=\"chinese\">\u003C\u002Fa>\n## 🇨🇳 中文说明\n\n一个极简、高性能的 Cloudflare WARP SOCKS5 Docker 代理。\n致力于为服务器提供极低资源占用的出口网络解耦方案。\n\n### 🌟 为什么选择 MicroWARP？\n\n市面上大多数 WARP 镜像（例如 `caomingjun\u002Fwarp`）依赖于 Cloudflare 官方的 `warp-cli` 守护进程。这种方式通常会导致较高的内存占用（约 **150MB+**），且在高并发场景下存在一定的性能瓶颈。\n\n**MicroWARP** 采用了不同的底层架构：\n1. **内核级 WireGuard**：采用 Linux 原生内核态的 `wg0` 接口接管流量，CPU 损耗近乎为零。\n2. **MicroSOCKS 引擎**：使用纯 C 语言编写的 `microsocks` 服务器，极大降低资源消耗。\n3. **极低内存占用**：高并发下内存占用依然 **\u003C 5MB**（实测常驻 800KB 左右），专为资源受限的云服务器环境打造。\n4. **原生兼容 Tailscale**：智能保留回程路由，解决全局接管导致的非对称路由黑洞，兼容异地组网直连。\n5. **多架构支持**：原生支持 `amd64` 和 `arm64`（兼容 ARM 架构机器）。\n\n### 🎯 典型应用场景\n**⚠️ 声明：本项目专为服务端 (Server-side) 设计，并非个人电脑本地代理软件。**\n\n1. **API 网络路由**：为服务器上的爬虫或大模型 API 网关（如 Grok \u002F ChatGPT）提供稳定的 Cloudflare 出口 IP。\n2. **服务端出口隐私**：挂载 MicroWARP 作为服务器的出站网关，隐藏 VPS 真实 IP，降低遭到溯源扫描的风险。\n3. **微服务 Sidecar**：极低的资源占用使其非常适合作为 Docker Sidecar 容器，为特定的后端服务提供独立的网络出口。\n\n### 📦 快速开始\n\n只需映射 `1080` 端口并赋予容器 `NET_ADMIN` 权限。新建一个 `docker-compose.yml`：\n\n```yaml\nservices:\n  microwarp:\n    image: ghcr.io\u002Fccbkkb\u002Fmicrowarp:latest\n    container_name: microwarp\n    restart: always\n    ports:\n      - \"127.0.0.1:1080:1080\" # 默认无密码 SOCKS5 端口，仅监听本机\n    cap_add:\n      - NET_ADMIN\n      - SYS_MODULE\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      - warp-data:\u002Fetc\u002Fwireguard # 持久化保存账号凭证\n\nvolumes:\n  warp-data:\n```\n\n启动容器：\n```bash\ndocker compose up -d\n```\n\n### ⚙️ 进阶配置：认证与网络连通性优化\n\nMicroWARP 支持通过环境变量进行参数定制：\n\n```yaml\n    environment:\n      - BIND_ADDR=0.0.0.0     # 监听地址 (默认 0.0.0.0)\n      - BIND_PORT=1080        # 监听端口 (默认 1080)\n      - SOCKS_USER=admin      # SOCKS5 认证用户名 (留空则为无密码模式)\n      - SOCKS_PASS=123456     # SOCKS5 认证密码\n      - GH_PROXY=https:\u002F\u002Fgithub.ednovas.xyz # 代理 wgcf 二进制下载地址\n      \n      # ⚠️ 网络连通性优化 (Port Hopping)\n      # 针对部分对 UDP 2408 端口存在 QoS 限制的机房（如 DMIT、搬瓦工等）。\n      # 可将端口修改为 4500 (标准 IPsec NAT-T 端口) 规避审查特征，提升连通率。\n      - ENDPOINT_IP=162.159.192.1:4500\n```\n\n### 🚀 扩展用法：转换为 HTTP 代理\n\n基于 Unix 哲学，底层镜像未内置 HTTP 解析引擎以维持极限轻量化。如需 HTTP 代理，推荐使用 `gost` 进行本地转换：\n```bash\nnohup gost -F=socks5:\u002F\u002Fadmin:123456@127.0.0.1:1080 -L=http:\u002F\u002F127.0.0.1:8081 > \u002Fdev\u002Fnull 2>&1 &\n```\n*注：请务必使用 `socks5:\u002F\u002F`（而非 `socks5h:\u002F\u002F`）以由宿主机处理 DNS 解析，避免启动时的解析超时问题。*\n\n---\n\n*特别鸣谢 __LinuxDo__ 社区* ❤️\n\n---\n\n## 📈 Star History\n\n\u003Ca href=\"https:\u002F\u002Fstar-history.com\u002F#ccbkkb\u002FMicroWARP&Date\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=ccbkkb\u002FMicroWARP&type=Date&theme=dark\" \u002F>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=ccbkkb\u002FMicroWARP&type=Date\" \u002F>\n    \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=ccbkkb\u002FMicroWARP&type=Date\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fa>\n","MicroWARP 是一个基于 Docker 的超轻量级 Cloudflare WARP SOCKS5 代理，仅需 800KB 内存。其核心功能包括通过内核态 WireGuard 接口实现几乎零 CPU 损耗的数据传输，以及使用纯 C 语言编写的 microsocks 服务器以最小化资源消耗。项目体积小巧（Docker 镜像大小仅为 9.08MB），非常适合在资源受限的环境中运行，如 1C1G VPS。此外，MicroWARP 支持多架构（amd64 和 arm64），并能无缝集成 Tailscale，解决不对称路由黑洞问题。该工具适用于需要利用高信任度 Cloudflare IP 进行 API 路由或希望增强出站隐私保护的场景。","2026-06-11 03:51:26","high_star"]