企业官网建设流程全解析

CrossInk 是一款运行在 Xteink X3/X4 等 ESP32 墨水屏设备上的开源电子阅读器固件。无需数据线，你可以通过它的内置 Web 服务器、Calibre 无线传输或 WebDAV 挂载三种方式，把 EPUB 电子书快速无线传到 CrossInk 阅读器里。本文将带你一步步完成连接与传书。

三种无线传书方式怎么选

三者都基于同一个内置 Web 服务器，详细技术说明见 docs/webserver.md 和 docs/webserver-endpoints.md。

方式一：用内置 Web 服务器传书（最推荐）

第 1 步：启动文件传输

在 CrossInk 主页选择File Transfer（文件传输），然后三选一：

• Join Network：连接家中已有的 Wi-Fi（仅支持 2.4 GHz）
• Create Hotspot：让阅读器自建热点，手机直接连它
• Calibre Wireless：配合 Calibre 插件使用（见下文）

连接成功后，屏幕会显示网址二维码和 IP 地址，例如http://192.168.1.102/，或更友好的域名http://crosspoint.local/。用同一网络下的手机或电脑浏览器打开即可。

第 2 步：上传书籍

进入File Manager页面，即可浏览 SD 卡目录，支持上传、下载、重命名、移动、删除文件和新建文件夹。点击右上角绿色的Upload按钮选择书籍即可：

💡小技巧：EPUB 优化上传。上传界面支持在浏览器端先优化 EPUB（压缩图片、转换为适合墨水屏的 JPEG），特别适合图片多的大体积书籍；若优化失败会自动回退为原文件。

方式二：从 Calibre 无线发送书籍

如果你平时用 Calibre 管理书库，可以安装 CrossPoint Reader 官方插件实现"一键发送到设备"：

1. 在 Calibre 中打开Preferences > Plugins > Load plugin from file，加载 crosspoint_reader 插件 ZIP 包，必要时重启 Calibre
2. 在阅读器上进入File Transfer > Calibre Wireless，让设备与电脑连上同一个 2.4 GHz Wi-Fi
3. 保持该屏幕常开，在 Calibre 中对选中书籍执行Send to device
4. 阅读器屏幕会实时显示传输进度，完成后即可开读

完整流程参见 docs/user-guide.md。

📖顺便一提：Calibre 还能通过 OPDS 目录把书库"共享"给 CrossInk——在阅读器中把 Calibre Content Server 地址（通常以/opds结尾）添加为 OPDS 服务器，就能在设备里直接浏览和下载书库中的书。

方式三：WebDAV 挂载，把阅读器当网络硬盘

CrossInk 的 Web 服务器内置了 WebDAV 兼容处理程序（与 HTTP 服务共用 80 端口），支持PUT、DELETE、MKCOL、MOVE、PROPFIND等标准方法，详见 docs/webserver-endpoints.md。

Windows 用户：使用RaiDrive等免费工具添加 WebDAV 网络驱动器，地址填阅读器屏幕上显示的http://IP地址/（或crosspoint.local），即可把 SD 卡挂载成本地盘符，拖拽传书。

macOS 用户：访达中按Cmd + K，在"服务器地址"输入http://crosspoint.local/，连接后设备就会出现在边栏里。

Linux 用户：命令行挂载即可：

mkdir -p ~/crossink mount -t davfs http://crosspoint.local/ ~/crossink

挂载后即可像操作本地文件夹一样直接复制书籍进去，PUT写入会先写临时文件再原子重命名，传输更安全。

传完书之后的阅读体验

书籍传到位后，翻开 CrossInk 就能享受为墨水屏优化的排版——Lexend Deca 与 Bitter 两款专为阅读流畅度设计的字体，10/12/14/16 pt 四档字号可选：

安全与实用注意事项

• ⚠️无认证：Web 服务器没有登录验证，请只在可信的私人网络使用；用完记得退出 File Transfer 模式省电
• 🔌端口说明：HTTP/WebDAV 在 80 端口，WebSocket 高速上传在 81 端口，UDP 发现服务在 8134 端口
• 📶只支持 2.4 GHz Wi-Fi，5 GHz 网络无法连接
• 🔄同名文件会被覆盖；通过 Web 覆盖/移动/删除 EPUB 时，旧缓存会自动清理，无需手动处理
• 📱找不到 crosspoint.local 域名？改用屏幕显示的 IP 地址访问即可
• 📚 如果两台 CrossInk 之间传书，还可以用无需网络的近场文件传输（ESP-NOW），说明见 docs/nearby-file-transfer.md

常见问题快速排查

总结

CrossInk 的无线传书功能开箱即用：日常传书用 Web 服务器最简单，重度书库用户选 Calibre 无线传输，追求"拖进去就完事"的体验就上 WebDAV 挂载。相关功能源码位于 src/network/CrossPointWebServer.cpp 与 src/network/WebDAVHandler.cpp，网页界面在 web/pages/ 目录中，感兴趣可以深入了解。