本地轻量级电子档案系统电子签章从零配置落地全步骤

一、准备环境与工具

本次采用无需复杂云账号的方案，所有工具均为开源免费、本地部署，适配Windows/Mac/Linux三平台。

1.1 必备软件

• 轻量级电子档案系统：Teedy（原Nuxeo Drive替代版，个人/小团队免费，专注本地文件归档）点击下载对应平台安装包
• 电子签章工具包：PDFSigner（开源纯Java工具，无需安装PDF阅读器）点击下载pdf-signer.jar
• Java运行环境：JRE 11+（PDFSigner依赖）点击下载对应平台JRE
• 自签名证书生成工具：OpenSSL（Windows/Mac/Linux通用）Windows下载Win32OpenSSL-1_1_1w.msi（Light版即可）；Mac/Linux直接用终端自带版本

1.2 测试环境验证

安装完所有工具后，打开终端（Windows用PowerShell，Mac/Linux用Terminal）输入以下命令，验证工具是否正常：

• Java验证：java -version（输出需含“version 11”或更高）
• OpenSSL验证：openssl version（Windows需重启PowerShell或添加环境变量后验证）

二、生成自签名电子签章证书

正式环境需用CA机构签发的证书，但本地/小团队测试可先用自签名证书，步骤一致。

2.1 创建证书目录

在桌面新建文件夹cert，后续所有证书、签章图片均放此处，避免路径错误。

2.2 生成RSA私钥

打开终端，cd到cert目录（Windows：cd C:\Users\你的用户名\Desktop\cert；Mac/Linux：cd ~/Desktop/cert），输入： ```bash openssl genrsa -des3 -out private_key.pem 2048 ```

输入至少4位私钥密码（务必记住，后续配置PDFSigner必须用），连续两次确认后，cert目录会生成private_key.pem。

2.3 生成自签名公钥证书

在同一终端目录下，输入： ```bash openssl req -new -x509 -key private_key.pem -days 3650 -out public_cert.pem ```

按提示依次输入（部分可留空，直接回车跳过）：

• Country Name：CN（或你的国家代码）
• State or Province：你的省份（如Beijing）
• Locality：你的城市（如Haidian）
• Organization：你的组织/个人名（如张三工作室）
• Organizational Unit：可留空
• Common Name：必填，证书持有者标识（如zhangsan@test.com）
• Email Address：你的邮箱

2.4 准备签章图片

在cert目录下放入一张透明背景PNG格式的签章图片（尺寸建议300×300像素以内），命名为stamp.png。

三、配置Teedy电子档案系统

3.1 安装并启动Teedy

• Windows：双击下载的teedy-windows-x64.exe，按提示默认安装，安装后启动程序
• Mac：双击Teedy.dmg，拖拽到应用程序文件夹，启动时若提示“无法打开”，需在系统设置-隐私与安全性中点击“仍要打开”
• Linux：根据下载的压缩包类型解压后，运行teedy.sh

首次启动会自动打开浏览器访问http://localhost:8080，注册第一个管理员账号（如admin/123456），登录后进入Teedy主界面。

3.2 配置Teedy外部签章工具

Teedy默认无内置签章功能，需通过“外部命令”插件调用PDFSigner：

1. 在Teedy主界面点击右上角齿轮图标→配置→外部命令→添加新命令
2. 填写配置项（所有内容均用英文引号包裹路径/密码，避免空格问题）：
   • 命令名称：PDF签章（可自定义）
   • 适用格式：仅勾选PDF
   • 适用操作：仅勾选“下载前处理”
   • 命令（Windows）："C:\Program Files\Eclipse Adoptium\jdk-11.0.22.7-hotspot\bin\java.exe" -jar "C:\Users\你的用户名\Desktop\cert\pdf-signer.jar" -i "{INPUT}" -o "{OUTPUT}" -c "C:\Users\你的用户名\Desktop\cert\public_cert.pem" -k "C:\Users\你的用户名\Desktop\cert\private_key.pem" -p "你的私钥密码" -s "C:\Users\你的用户名\Desktop\cert\stamp.png" -x 50 -y 50 -w 100 -h 100
   • 命令（Mac/Linux）："java" -jar "/Users/你的用户名/Desktop/cert/pdf-signer.jar" -i "{INPUT}" -o "{OUTPUT}" -c "/Users/你的用户名/Desktop/cert/public_cert.pem" -k "/Users/你的用户名/Desktop/cert/private_key.pem" -p "你的私钥密码" -s "/Users/你的用户名/Desktop/cert/stamp.png" -x 50 -y 50 -w 100 -h 100
3. 点击测试命令，系统会弹出临时PDF测试，若生成带签章的PDF，点击保存

注：命令参数说明（可按需调整）：

• -i：Teedy传入的原始PDF路径（必须保留{INPUT}占位符）
• -o：Teedy要求的输出路径（必须保留{OUTPUT}占位符）
• -c：公钥证书路径
• -k：私钥路径
• -p：私钥密码
• -s：签章图片路径
• -x：签章左下角到PDF左边缘的距离（单位：点，1点≈0.35mm）
• -y：签章左下角到PDF下边缘的距离
• -w：签章宽度
• -h：签章高度

四、实际落地操作：上传PDF并自动签章

4.1 上传PDF到Teedy

在Teedy主界面点击左上角上传按钮，拖拽需要归档的PDF文件，添加必要的元数据（如档案编号、创建时间、负责人）后点击保存。

4.2 下载已签章的归档PDF

找到刚上传的PDF文件，点击文件右侧的操作→下载，系统会自动调用刚才配置的PDFSigner工具，直接下载带合法电子签章的PDF。

4.3 验证电子签章合法性

用Adobe Acrobat Reader DC（点击下载）打开下载的PDF，点击左侧工具栏的签名面板→签名，可看到“自签名但有效”的验证结果（正式CA证书会显示“已验证身份”）。

五、常见卡壳问题解决

• PowerShell提示OpenSSL不是内部命令：Windows安装Win32OpenSSL时勾选“Add OpenSSL to the system PATH for all users”，或手动将C:\Program Files\OpenSSL-Win64\bin添加到系统环境变量Path中，重启PowerShell
• Teedy测试命令失败：检查所有路径是否用英文引号包裹、私钥密码是否正确、PDFSigner.jar和cert目录是否存在、Java版本是否≥11
• 签章位置不对：调整命令中的-x/-y/-w/-h参数，可先在本地用PDFSigner单独测试：java -jar pdf-signer.jar -i test.pdf -o signed.pdf -c public_cert.pem -k private_key.pem -p 密码 -s stamp.png -x 50 -y 50 -w 100 -h 100，调整参数直到满意