5分钟搭建你的PDF内Linux环境：LinuxPDF终极入门指南

5分钟搭建你的PDF内Linux环境：LinuxPDF终极入门指南

【免费下载链接】linuxpdfLinux running inside a PDF file via a RISC-V emulator项目地址: https://gitcode.com/gh_mirrors/li/linuxpdf

LinuxPDF是一个令人惊叹的创新项目，它让你能够在PDF文件中运行完整的Linux系统，通过RISC-V模拟器实现这一看似不可能的任务。本文将带你快速了解这个神奇的工具，并通过简单步骤搭建属于你的PDF内Linux环境。

🚀 什么是LinuxPDF？

LinuxPDF是基于TinyEMU的RISC-V模拟器项目，它利用PDF文件格式对JavaScript的支持，在PDF内部构建了一个完整的Linux运行环境。你可能以为PDF只能包含静态文档，但实际上PDF格式支持JavaScript及其标准库，现代浏览器（如Chromium、Firefox）的PDF引擎都实现了这一功能。

这个项目的核心原理是将C代码编译为asm.js（而非WebAssembly），然后在PDF中运行修改版的TinyEMU RISC-V模拟器。输入输出通过文本字段模拟像素行来实现显示，虚拟键盘则通过按钮和文本框接收用户输入。

⚙️ 系统要求与兼容性

• 浏览器要求：仅支持基于Chromium的浏览器
• 性能考量：由于Chrome PDF引擎禁用了V8的JIT编译器，性能会受到影响。Linux内核启动大约需要30-60秒，比正常情况慢100倍以上
• 文件系统：提供32位和64位两种版本，默认是32位buildroot系统（来自TinyEMU示例），也可选择64位Alpine Linux系统（性能较慢）

📦 快速安装步骤

1. 克隆仓库

首先，克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/li/linuxpdf cd linuxpdf

2. 创建并激活虚拟环境

python3 -m venv .venv source .venv/bin/activate

3. 安装依赖

pip3 install -r requirements.txt

4. 构建项目

./build.sh

如果需要构建64位版本而非32位版本，编辑build.sh并修改BITS="32"行。build.sh脚本会自动下载Emscripten 1.39.20，注意：必须在Linux系统上构建。

5. 运行Web服务器

生成的文件将位于out/目录中，运行以下命令启动Web服务器：

(cd out; python3 -m http.server)

💡 使用指南

构建完成后，你可以通过访问Web服务器来体验LinuxPDF。点击"Start Emulator"按钮即可在浏览器中打开包含Linux系统的PDF文件。

由于性能限制，系统启动可能需要几分钟时间，请耐心等待。启动完成后，你可以通过虚拟键盘与Linux系统交互，体验在PDF中运行Linux的独特乐趣。

🛠️ 项目结构解析

LinuxPDF项目主要包含以下关键组件：

• TinyEMU模拟器：位于tinyemu/目录，包含RISC-V模拟器的核心代码，如riscv_cpu.c和machine.c
• Web界面：位于web/目录，包含index.html和index.css等前端文件
• 构建脚本：build.sh负责项目的编译和打包过程
• 配置文件：vm_32.cfg和vm_64.cfg分别对应32位和64位系统的配置

🙏 项目 credits

本项目由@ading2210开发，RISC-V模拟器基于Fabrice Bellard编写的TinyEMU项目。

📄 许可证信息

本项目采用GNU GPL v3许可证，详细信息见LICENSE文件。

【免费下载链接】linuxpdfLinux running inside a PDF file via a RISC-V emulator项目地址: https://gitcode.com/gh_mirrors/li/linuxpdf