匿名網路社群文件 | Anoni.net Docs

推廣與翻譯匿名網路 Tor、Tails 與 OONI 觀測工具

此專案是「匿名網路社群 Anoni.net」的核心文件系統，致力於推廣網路自由與隱私保護工具。專案包含多語系文件網站、Tor 中繼監控系統，以及 OONI 觀測資料分析工具。

📚 專案結構

anoni-net-docs/
├── docs/           # MkDocs 多語系文件網站（zh-TW, zh-CN, en）
├── pulse/          # Tor 中繼監控系統（FastAPI + PostgreSQL）
└── asn_coverage/   # OONI 觀測資料與 ASN 涵蓋率分析工具

1. Docs - 文件網站

基於 MkDocs Material 的多語系文件系統，提供繁體中文、簡體中文與英文三種語言版本。

主要內容：

• Tor、Tails、OONI 教學與翻譯文件
• 社群活動資訊與工作坊內容
• 網路審查觀測報告
• 參與專案的指南

技術特點：

• 多語系支援（zh-TW / zh-CN / en）
• 內建部落格系統與 RSS 訂閱
• Vega-Lite 資料視覺化圖表
• 支援標準網站、IPFS、Tor Onion 多種部署方式

2. Pulse - Tor 中繼監控系統

即時監控與統計 Tor 網路中繼資料的系統，提供 API 供前端查詢與視覺化。

功能特點：

• 定期收集指定國家（TW、JP、KR、HK）的 Tor 中繼資料
• PostgreSQL 資料庫儲存歷史紀錄
• FastAPI REST API 與 Vega-Lite 圖表端點
• Docker Compose 一鍵部署

技術架構：

• Backend: Python 3.12+ / FastAPI / psycopg 3
• Database: PostgreSQL 17
• Scheduler: Alpine crond
• Deployment: Docker + Docker Compose

3. ASN Coverage - OONI 涵蓋率分析

分析 OONI 觀測資料在各區域 ASN 的涵蓋狀況，協助識別測量盲點。

資料來源：

• OONI AWS S3 公開資料集（ooni-data-eu-fra）
• 支援回溯歷史資料與指定時間區間分析

主要功能：

• 統計各 ASN 的 OONI 測量次數
• 多執行緒平行下載與處理
• 輸出 CSV 格式分析報告

🚀 快速開始

環境需求

• Python: 3.12+
• 套件管理: uv
• Docker: 用於 Pulse 系統部署（可選）

安裝 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

本地開發

Docs 文件網站

cd docs
uv sync
source .venv/bin/activate
mkdocs serve  # 預設啟動 zh-TW 版本

開啟瀏覽器訪問 http://127.0.0.1:8000

Pulse 監控系統

cd pulse
cp .env.sample .env
# 編輯 .env 設定資料庫密碼等

docker-compose up -d

API 文件位於：http://localhost:8000/api/readme

ASN Coverage 分析工具

cd asn_coverage
uv sync

# 回溯最近 36 小時的 TW 觀測資料
uv run python ooni.py lookback --units=36 --loc=TW --frame=hours

📖 文件與資源

• 線上文件: https://anoni.net/docs/
• GitHub Repo: https://github.com/anoni-net/docs
• Tor Onion: docs.anoninetru5tflukgfaehun7q6khowgmymcff3gtk5oyesqazhmfxtyd.onion
• 詳細開發指南: 請參閱 CLAUDE.md

🤝 貢獻

我們歡迎任何形式的貢獻！無論是翻譯文件、回報問題、提出建議或提交程式碼。

• 文件貢獻：直接編輯 docs/{語言}/ 目錄下的 Markdown 檔案
• 問題回報：使用 GitHub Issues
• 程式碼貢獻：Fork 後提交 Pull Request

📝 授權

• 文件內容: CC-BY 4.0
• 程式碼: MIT License（見各子專案的 LICENSE 檔案）

---

Copyright © 2023-2025 Anoni.net Docs Project

---

Anoni.net Documentation

Promoting and translating Tor, Tails, and OONI measurement tools for anonymous networks

This project is the core documentation system for the "Anonymous Network Community Anoni.net", dedicated to promoting internet freedom and privacy protection tools. The project includes a multilingual documentation website, a Tor relay monitoring system, and OONI measurement data analysis tools.

📚 Project Structure

anoni-net-docs/
├── docs/           # MkDocs multilingual documentation site (zh-TW, zh-CN, en)
├── pulse/          # Tor relay monitoring system (FastAPI + PostgreSQL)
└── asn_coverage/   # OONI measurement data and ASN coverage analysis tool

1. Docs - Documentation Website

A multilingual documentation system based on MkDocs Material, providing Traditional Chinese, Simplified Chinese, and English versions.

Main Content:

• Tor, Tails, and OONI tutorials and translated documentation
• Community activity information and workshop content
• Internet censorship observation reports
• Guides for project participation

Technical Features:

• Multilingual support (zh-TW / zh-CN / en)
• Built-in blog system with RSS feed
• Vega-Lite data visualization charts
• Support for standard web, IPFS, and Tor Onion deployment

2. Pulse - Tor Relay Monitoring System

A system for real-time monitoring and statistics of Tor network relay data, providing APIs for frontend queries and visualization.

Key Features:

• Periodically collect Tor relay data from specified countries (TW, JP, KR, HK)
• PostgreSQL database for historical records
• FastAPI REST API with Vega-Lite chart endpoints
• One-click deployment with Docker Compose

Technical Stack:

• Backend: Python 3.12+ / FastAPI / psycopg 3
• Database: PostgreSQL 17
• Scheduler: Alpine crond
• Deployment: Docker + Docker Compose

3. ASN Coverage - OONI Coverage Analysis

Analyze OONI measurement data coverage across regional ASNs to help identify measurement blind spots.

Data Source:

• OONI AWS S3 public dataset (ooni-data-eu-fra)
• Support for historical data lookback and specified time range analysis

Main Features:

• Statistics on OONI measurements per ASN
• Multi-threaded parallel download and processing
• Output analysis reports in CSV format

🚀 Quick Start

Requirements

• Python: 3.12+
• Package Manager: uv
• Docker: For Pulse system deployment (optional)

Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh

Local Development

Docs Documentation Website

cd docs
uv sync
source .venv/bin/activate
mkdocs serve  # Default: zh-TW version

Open browser and visit http://127.0.0.1:8000

Pulse Monitoring System

cd pulse
cp .env.sample .env
# Edit .env to configure database password, etc.

docker-compose up -d

API documentation available at: http://localhost:8000/api/readme

ASN Coverage Analysis Tool

cd asn_coverage
uv sync

# Lookback recent 36 hours of TW measurement data
uv run python ooni.py lookback --units=36 --loc=TW --frame=hours

📖 Documentation & Resources

• Online Documentation: https://anoni.net/docs/
• GitHub Repo: https://github.com/anoni-net/docs
• Tor Onion: docs.anoninetru5tflukgfaehun7q6khowgmymcff3gtk5oyesqazhmfxtyd.onion
• Detailed Development Guide: See CLAUDE.md

🤝 Contributing

We welcome contributions of all kinds! Whether it's translating documentation, reporting issues, suggesting improvements, or submitting code.

• Documentation contributions: Directly edit Markdown files in docs/{language}/ directories
• Issue reporting: Use GitHub Issues
• Code contributions: Fork and submit Pull Requests

📝 License

• Documentation Content: CC-BY 4.0
• Code: MIT License (see LICENSE files in each subproject)

---

Copyright © 2023-2025 Anoni.net Docs Project