首页 文章 精选 留言 我的

精选列表

搜索[Arch Linux],共10000篇文章
优秀的个人博客,低调大师

一个让我的开源项目在 Linux 上 100% 装不上的回车符

我维护一个 GPU 能耗测量工具(MLCube 容器格式)。昨天一位复现者在干净的 Ubuntu 22.04 上跑"一键脚本",反馈:100% 失败。截图里第一行报错就是标题这句——`set: pipefail: invalid option name`。 熟悉的人一眼就能看出后面的 `\r`:这是 Windows 行尾符(CRLF)的经典症状。bash 读到 `pipefail\r` 时,`\r` 不是空白字符,于是把 `pipefail\r` 当成一个不存在的选项名。 ## 排查:比预想的严重得多 我一开始以为只是单个脚本的问题。逐个核对字节后发现问题全在:仓库里 **9 个 shell 脚本全部是 CRLF**——入口 `run.sh`(197 行)、`quickstart.sh`(368 行)、部署用的六个脚本,连站点的"下载器" stub 自己也是 CRLF。源头不是 release 上传时损坏,而是仓库 blob 本身就是 CRLF——在 Windows 上开发、git autocrlf 配置不严谨,行尾就这样一路带进了每个发布资产。 最有讽刺意味的一处:复现者下载完先做了 SHA-256 校验,**通过了**——然后脚本炸了。原因很简单:校验和就是对着 CRLF 版本算的,文件和校验和"自洽地错"。校验和保障的是完整性(没被篡改),不保障正确性(行尾本身就是错的)。一排错误的字节配上一个匹配错误的校验和,安全校验做得再好也拦不住。 ## 修复:四件事一起做 单把文件转回 LF 不够,得保证不再复发: 1. **源码全量转 LF**,9 个 `.sh` 逐一字节级替换,并补上仓库里缺失的 wrapper 源文件; 1. **`.gitattributes` 钉死规则**:`*.sh text eol=lf`——以后不管谁在什么平台上 clone、提交,仓库里的 `.sh` 永远是 LF; 1. **CI 加行尾守卫**:每次 CI 显式检查 `.sh` 不含 CR,从源头报警; 1. **重新发布**:发布 v2 资产并换绑,v1 保留作墓碑,不悄悄删——让老用户的报错可追溯。 替换旧 release 资产时还顺手抓到一个潜伏 bug:checksum 清单里 schema 文件的哈希**从来就没对上过**。为什么一直没被发现?因为校验流程测的是脚本资产,schema 那行从没人校验过——**没人去校验校验和文件本身**。发布即验证,发布即发现。 ## 修 CRLF 时踩的坑:在 Windows 上修 Windows 的问题 还有个工程细节值得一提:修复过程中我先用 Git Bash 的 `sed 's/\r$//'` 做替换,**静默失败**——MSYS 的 text-mode 会在管道里自动做行尾转换,导致你以为在删 `\r`,实际读进来的早就被转换过,`grep -c $'\r'` 的计数也会撒谎。最后是用 Python 的 `read_bytes`/`write_bytes` 做纯字节替换才可靠。也就是说:**在 Windows 上修 CRLF 问题,工具链本身就会被 CRLF 坑**。 ## 教训 - 一键脚本是新用户的**第一触点**,它挂了,别人对项目的第一印象就是"这项目装不上",后面写得再好都没机会展示; - Windows 上开发跨平台项目,`.gitattributes` 不是可选项,是第一天就该有的东西; - 校验和能自洽地错——它验证完整性,不验证正确性; - 见到 `xxx: invalid option name` 或 `$'do\r': command not found`,先查行尾,再查别的。

优秀的个人博客,低调大师

从零开始:在Linux服务器上通过Docker部署PDF3MD全攻略

# 一、PDF3MD介绍 ## 1.1 PDF3MD简介 > `PDF3MD` 是一款基于 Web 的文档转换工具,采用 React 前端与 Python Flask 后端架构,专注于将 PDF 文件高效、准确地转换为结构清晰的 Markdown 和 Microsoft Word(DOCX)格式,并提供实时进度反馈与友好的用户交互体验。 ## 1.2 PDF3MD主要特点 - **PDF 转 Markdown**:将 PDF 文档智能转换为结构清晰、可读性强的 Markdown 格式。 - **Markdown 转 DOCX**:利用 Pandoc 将 Markdown 内容高保真地导出为 Word(.docx)文件。 - **多文件上传**:支持同时上传并批量处理多个 PDF 文件,提升转换效率。 - **拖拽上传界面**:提供拖放或传统选择两种方式,简化文件上传操作。 - **实时进度跟踪**:在转换过程中为每个文件提供详细的实时状态更新。 - **文件信息展示**:清晰显示原始文件名、大小、页数及转换时间等元数据。 - **现代响应式 UI**:界面简洁直观,适配桌面与移动设备,确保跨平台良好体验。 # 二、本次实践规划 ## 2.1 本地环境规划 > 本次实践为个人测试环境,操作系统版本为 Ubuntu 24.04.2 LTS。 |hostname|IP地址 |操作系统版本 |Docker版本 |部署项目|备注| | --- | --- | --- | --- | --- | --- | |jeven|192.168.3.88 |Ubuntu 24.04.2 LTS|28.5.0 |PDF3MD |——| ## 2.2 本次实践介绍 > 1.本次实践部署环境为个人测试环境,生产环境请谨慎; > 2.在Docker环境下部署PDF转Markdown工具PDF3MD。 # 三、本地环境检查 ## 3.1 检查Docker服务状态 > 检查Docker服务是否正常运行,确保Docker正常运行。 ``` root@jeven:~# systemctl status docker ● docker.service - Docker Application Container Engine Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled) Active: active (running) since Tue 2025-12-02 00:51:31 CST; 1min 11s ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID: 75393 (dockerd) Tasks: 32 Memory: 34.1M (peak: 34.8M) CPU: 1.248s CGroup: /system.slice/docker.service ``` ![](https://developer.qcloudimg.com/http-save/yehe-4995888/abb255efc952dabcb17c36c31c1cd133.png) ## 3.2 检查Docker版本 > 检查Docker版本 ``` root@jeven:~# docker -v Docker version 28.5.0, build 887030f ``` ## 3.3 检查docker compose 版本 > 检查Docker compose版本,确保2.0以上版本。 ``` root@jeven:~# docker compose version Docker Compose version v2.39.4 ``` # 四、拉取PDF3MD镜像 > 下载PDF3MD镜像,执行以下命令: ``` docker pull registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-backend:latest ``` ``` docker pull registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-frontend:latest ``` ![](https://developer.qcloudimg.com/http-save/4995888/887b97e647aabc6a88873f491ede3974.png) # 五、部署PDF3MD服务 ## 5.1 创建部署目录 - 创建部署目录 ``` mkdir -p /data/pdf3md/data && cd /data/pdf3md ``` - 目录权限设置: ``` chmod -R 777 /data/pdf3md ``` ## 5.2 docker compose方式部署 > 新建及编辑docker-compose.yaml文件,宿主机映射端口可自行设置,注意防止端口冲突。 ``` vim docker-compose.yaml ``` ``` services: backend: image: registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-backend:latest container_name: pdf3md-backend restart: unless-stopped ports: - "6201:6201" volumes: - ./data:/app/temp environment: - PYTHONUNBUFFERED=1 - FLASK_ENV=production - TZ=Asia/Shanghai healthcheck: test: ["CMD", "curl", "-f", "http://localhost:6201/"] interval: 30s timeout: 10s retries: 3 start_period: 40s frontend: image: registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-frontend:latest container_name: pdf3md-frontend restart: unless-stopped ports: - "9960:3000" environment: {} depends_on: - backend healthcheck: test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3000/"] interval: 30s timeout: 10s retries: 3 start_period: 40s ``` ## 5.3 创建PDF3MD容器 > 执行以下命令,创建PDF3MD容器。 ``` docker compose up -d ``` ![](https://developer.qcloudimg.com/http-save/4995888/9d43cc2c746ed170a7457d67229b28bb.png) ## 5.4 查看PDF3MD容器状态 > 检查PDF3MD容器运行状态,确保PDF3MD容器正常启动。 ``` root@jeven:/data/pdf3md# docker compose ps NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS pdf3md-backend registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-backend:latest "python app.py" backend 39 seconds ago Up 38 seconds (health: starting) 0.0.0.0:6201->6201/tcp, [::]:6201->6201/tcp pdf3md-frontend registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-frontend:latest "docker-entrypoint.s…" frontend 39 seconds ago Up 38 seconds (healthy) 0.0.0.0:9960->3000/tcp, [::]:9960->3000/tcp ``` ![](https://developer.qcloudimg.com/http-save/4995888/b906ceaabc99440403ac0620f54a1e89.png) ## 5.5 检查PDF3MD容器日志 > 检查容器运行日志,确保PDF3MD服务正常运行。 ``` docker compose logs ``` ![](https://developer.qcloudimg.com/http-save/4995888/b6c01ca572cc3f6fb2d89d73c0dcb2b9.png) # 六、访问PDF3MD服务 ## 6.1 访问PDF3MD首页 > 浏览器地址: `http://:9960`,访问PDF3MD初始页。如果无法访问,请确保宿主机的防火墙已关闭或已放行相关端口,对于云服务器还需配置相应的安全组规则。 ![](https://developer.qcloudimg.com/http-save/4995888/2918d44dd3bcb226bbc70f38b7037787.png) ## 6.2 文档转化 > 将测试PDF文档转化为Markdown格式文档,效果如下: ![](https://developer.qcloudimg.com/http-save/4995888/5544e88f9219aa573d606251a42d42a1.png) # 七、总结 > 本次实践通过 Docker 成功部署了 PDF3MD,验证了其作为一款轻量级 PDF 转 Markdown/DOCX 工具的便捷性与实用性。借助 Docker Compose,前后端服务快速启动,无需手动配置复杂依赖,极大简化了部署流程。PDF3MD 提供的拖拽上传、多文件处理和实时进度反馈功能,显著提升了文档转换效率和用户体验。

资源下载

更多资源
优质分享App

优质分享App

近一个月的开发和优化,本站点的第一个app全新上线。该app采用极致压缩,本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

腾讯云软件源

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题,腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构,目前腾讯云软件源站支持公网访问和内网访问。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

用户登录
用户注册