英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

200 OK 网页服务器

跨平台的继任者 Chrome 网络服务器，由原作者重新构建。

原来的 Chrome 应用被 200,000 人用于本地网页开发和文件共享。由于 Google 停止了 Chrome 应用，所以 200 OK 网页服务器继续使用这一简单的工作流程，包括：

• Chrome 扩展程序 — 已安装服务器应用的熟悉启动器
• 桌面应用 — 面向 Mac、Windows 和 Linux 的原生应用（Tauri）
• Android / ChromeOS — 在 Google Play 上发布的原生应用
• iOS — 使用 SwiftUI/Swift 的原生应用，支持前台服务（接受源文件/设备；App Store 发布待定）
• ChromeOS Linux — 针对没有 Google Play 的 Chromebook 的小型 Rust 启动器/控制器

同一作者。同一使命。现代架构。

在寻找原来的 Chrome 应用源代码？请参阅 legacy 分支。

反馈、建议与支持 · 源代码 · MIT 许可证

当前状态

Chrome 扩展程序、Android 应用、ChromeOS Linux 组件以及签名桌面 v0.1.5 已发布。服务器运行时有意未统一：

• Android 源码在其 Compose UI 背后使用本地 Kotlin HTTP/存储核心；
• 桌面 v0.1.5 在 Tauri/React 控制界面背后使用独立的 Rust HTTP 核心；
• iOS 源码在 SwiftUI 背后使用其自己的 Swift HTTP/存储核心，并且当应用进入后台时停止；
• ChromeOS Linux 控制器重用该 Rust 核心；
• 扩展程序是启动器/状态界面，而不是 HTTP 服务器。

桌面 main 使用独立的 Rust 核心处理 HTTP、文件系统和服务器生命周期工作；其 Tauri WebView 仅作为静态 React 控制界面。签名桌面 v0.1.5 包含优先 AppImage 的 Linux 安装、本地主机重启修复、Linux ARM64 包以及包感知的签名更新。此前的 Node/TypeScript CLI 从未发布到 npm，并已退役。GitHub 发布 android-v0.2.1 包含已签名的本地 Kotlin APK 和 AAB，并进行物理验证的 ChromeOS LAN 地址修正。维护者报告 v0.2.1 已提交至 Play；在审核和部署完成前，Play 可能继续提供早期构件。

一个独立的本地 iOS 应用现已实现但未发布。它使用 SwiftUI 和 Swift HTTP/存储实现，复用产品艺术资源而非其他平台代码，并且在 iOS 应用进入后台时停止。其模拟器/发布关卡及同 Wi-Fi 外部 HTTP 测试已在附带的实体 iPhone 上通过；App Store 打包和 TestFlight 是剩余的独立工作。

请参阅实时的 产品品牌决策、桌面运行时决策、Android 运行时决策、iOS 运行时决策、ChromeOS 扩展启动器决策、ChromeOS Crostini 启动器/控制器决策 以及 活跃扩展/ChromeOS 关闭记录。无 Play 的 Linux 备用计划记录在 Crostini 战术 中。

安装

• Chrome 扩展程序：Chrome 网上应用店上的 200 OK Web Server
• Android / ChromeOS：Google Play 上的 200 OK
• 桌面应用程序：下载最新签名版本。在 Linux 上推荐使用 AppImage，因为它可以在无需管理员密码的情况下安装和更新；DEB 和 RPM 则依然是辅助系统软件包。Linux 软件包发布适用于 x86_64 和 ARM64。
• 没有 Google Play 的 ChromeOS：请按照 ChromeOS Linux 设置指南 操作。

核心服务功能

• 带 MIME 类型检测的静态文件服务
• 为目录自动提供 index.html
• 带文件大小和日期的目录列表
• ETag / If-None-Match (304) 以及字节范围支持
• 路径遍历保护
• 显式启动/停止生命周期

路线图

即将推出

• 打包、TestFlight 测试、审核并接受与 App Store 提供的原生 iOS 应用完全相同的版本
• 完成提交的 Android 应用及以启动器为重点的扩展候选版本的商店审核、发布及受控交付证明
• 完成最终的旧版 Chrome 应用迁移更新
• 决定哪些支持的产品界面应添加上传、HTTPS 或认证功能

稍后

• 用于在局域网轻松移动访问的二维码
• 实时重载
• 多重同时服务器
• 反向代理模式

完整路线图请参见 docs/vision.md

架构

该存储库包含三个受支持的服务器核心以及使用或启动它们的平台应用程序：

packages/ui/         Shared React controls used by the desktop webview
extension/           Chrome Extension
desktop/             Tauri/React controls plus Rust application state
desktop/core/        Rust HTTP core and repository-only smoke executable
desktop/crostini/    ChromeOS Linux launcher/controller using the Rust core
android/             Compose app plus Kotlin HTTP/storage and lifecycle core
ios/                 SwiftUI app plus Swift HTTP/storage and foreground lifecycle

桌面和 ChromeOS Linux 使用原生 Rust，Android 使用原生 Kotlin，iOS 使用原生 Swift。它们的核心功能契约通过测试保持大体兼容，而不是通过共享运行时源码。Tauri Webview 保留用于配置和控制，而原生 Rust 负责桌面套接字、文件系统访问、HTTP 行为以及服务器生命周期。小型 ok200-core 可执行文件仅用于仓库开发和冒烟测试；它不是独立打包的 CLI 产品。权威运行时边界位于 docs/topics/desktop-runtime.md 和 docs/topics/android-runtime.md。

iOS 源码是位于 ios/ 下的独立原生 SwiftUI/Swift 实现；其开发候选版本已被物理接受，但尚未有 App Store 发布。详见 docs/topics/ios-runtime.md 和 docs/tactical/017-ios-store-readiness.md。

从 Chrome 应用迁移

如果您是原 Web Server for Chrome 的用户：

1. 新扩展发布在此： Chrome 网上应用店列表
2. Android / ChromeOS 应用发布在此： Google Play 列表
3. 扩展启动服务器应用程序；它本身不包含服务器。
4. 功能等价性是一个方向，而不是声称每个旧版本选项都已可用。

迁移状态及最终遗留更新计划见 docs/topics/legacy-app-migration.md。

开发

pnpm install
pnpm build       # build frontend applications and shared UI
pnpm test        # run tests
pnpm typecheck   # type check
pnpm lint        # lint with Biome

针对 Rust 原生桌面工作区及其内部 smoke 可执行文件：

cd desktop
cargo run -p ok200-core -- --root .. --port 0
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace

对于原生 iOS 应用程序：

ios/scripts/check.sh          # simulator unit/UI tests and Release hygiene
ios/scripts/device-smoke.sh   # signed phone install, LAN fetch, background stop

许可

麻省理工学院