从零搭建符合企业规范的轻量开源零门槛档案管理系统全流程

一、前置准备：明确企业规范核心要求+必备工具

先梳理企业规范的通用必填项，再准备100%可用的开源工具：

• 企业通用档案规范锚点：3级分类、权限分层（管理员/部门主管/普通员工）、操作日志全留痕、PDF预览、上传加密（仅系统内访问）、到期提醒（需手动配置，但开源工具预留字段）
• 环境要求：Windows/Mac/Linux任意系统，Python 3.8+（别装3.13，部分依赖不兼容）
• 开源工具：OnlyOffice Community Server 轻量档案版，下载地址：Linux Debian/Ubuntu、Windows/Mac（含Docker一键包，新手选Docker）

二、Docker一键部署（新手首选，零配置环境）

2.1 安装Docker（含Docker Compose）

• Windows/Mac：直接下载安装Docker Desktop，官网地址：https://www.docker.com/products/docker-desktop/，安装后重启电脑，打开托盘确认Docker Desktop正常运行（图标为亮蓝色鲸鱼）
• Linux（Ubuntu 20.04+/Debian 11+）：复制以下命令逐行执行：
  • 更新包索引：sudo apt update
  • 安装依赖：sudo apt install -y ca-certificates curl gnupg lsb-release
  • 添加Docker GPG密钥：sudo mkdir -m 0755 -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  • 添加Docker仓库：echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  • 再次更新并安装：sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  • 验证Docker：sudo docker run hello-world

2.2 拉取并启动轻量档案OnlyOffice Docker镜像

新建一个名为onlyoffice-archive的文件夹，进入后新建docker-compose.yml，粘贴完整配置：

version: '3.7'
services:
onlyoffice-community-server:
image: onlyoffice/communityserver:12.1.0.1760
container_name: onlyoffice-archive
restart: always
ports:
- "80:80"
- "443:443"
volumes:
- ./data:/var/www/onlyoffice/Data
- ./logs:/var/log/onlyoffice
environment:
- ONLYOFFICE_LICENSE=FREE
- ONLYOFFICE_DB_TYPE=POSTGRESQL
- POSTGRESQL_SERVER_HOST=onlyoffice-postgres
- POSTGRESQL_SERVER_PORT=5432
- POSTGRESQL_SERVER_DB_NAME=onlyoffice
- POSTGRESQL_SERVER_USER=onlyoffice
- POSTGRESQL_SERVER_PASSWORD=archive123456
onlyoffice-postgres:
image: postgres:14-alpine
container_name: onlyoffice-postgres
restart: always
volumes:
- ./postgres_data:/var/lib/postgresql/data
environment:
- POSTGRES_DB=onlyoffice
- POSTGRES_USER=onlyoffice
- POSTGRES_PASSWORD=archive123456

• 保存后启动：终端进入onlyoffice-archive文件夹，执行sudo docker-compose up -d（Windows/Mac不需要sudo）
• 等待初始化：首次启动约5-10分钟（取决于网速），通过访问http://localhost查看是否进入登录页（如果是服务器，替换成服务器公网IP）

三、企业规范初始化配置

3.1 管理员账号创建

• 首次进入登录页，点击“Create new portal”
• 填写必填信息：域名（随便填，比如company-archive.local，仅内部使用）、管理员邮箱（必填，后续找回密码用）、密码（至少8位，含字母+数字+特殊符号）
• 点击“Create portal”，等待1-2分钟自动跳转至管理后台

3.2 3级企业档案分类设置

• 进入管理后台左侧菜单：Documents → Settings → Folders
• 点击“Add root folder”添加1级分类，比如“行政档案”“财务档案”“技术档案”“人事档案”
• 点击1级分类右侧“⋮”→“Add subfolder”添加2级分类，比如“行政档案”下加“公文通知”“会议纪要”“办公设备采购”
• 点击2级分类右侧“⋮”→“Add subfolder”添加3级分类，比如“公文通知”下加“202X年公司发文”“202X年政府部门来文”
• 企业规范额外设置：所有1级分类右侧“⋮”→“Edit folder permissions”，取消勾选“Everyone → Create/Edit/Delete”，仅保留“Everyone → Read”（后续通过权限分层调整）

3.3 权限分层配置

• 创建部门和角色：
  • 左侧菜单：People → Departments → Add department，创建行政部、财务部、技术部、人事部
  • 左侧菜单：People → Roles → Add role，创建“部门档案主管”，权限勾选：对应1级/2级/3级本部门分类的“Create/Edit/Delete/Read”，操作日志的“View only”
• 创建员工并分配权限：
  • 左侧菜单：People → Users → Add user，填写邮箱、姓名、初始密码（强制勾选“Force change password on first login”）
  • 点击“Departments”标签页，勾选对应部门
  • 点击“Roles”标签页，勾选对应角色（仅选管理员或部门档案主管，普通员工不选额外角色，默认“Everyone → Read”所有公开档案）
  • 隐藏部门间档案：编辑非本部门的1级分类，取消勾选“Everyone → Read”，仅添加对应部门的“Group”为“Read/其他对应权限”

3.4 操作日志全留痕开启

• 左侧菜单：Settings → Audit trail
• 全部勾选以下选项：“Track all actions in Documents module”“Track user login/logout”“Track role/permission changes”
• 点击“Save”，后续可通过该模块查看所有操作时间、操作人、操作内容、IP地址

四、日常档案管理企业规范落地

4.1 档案上传规范（系统强制配合）

• 员工只能上传到有权限的3级子分类，不能跳过1级/2级
• 上传时必须填写系统预留的自定义字段（可新增到期日期、档案编号）：
  • 新增自定义字段：左侧菜单：Documents → Settings → Custom fields → Add custom field，创建“档案编号”（Text类型，Required）、“到期日期”（Date类型，Required）
  • 设置到期提醒：OnlyOffice预留API，可使用定时任务Python脚本实现（见下文4.2）
• 上传的Word/Excel/PowerPoint会自动转换为PDF格式（保留原文件，预览PDF，禁止下载可修改的原文件）：
  • 左侧菜单：Documents → Settings → General
  • 勾选“Automatically convert uploaded documents to PDF”
  • 点击“Save”

4.2 到期提醒Python脚本（可直接复制使用）

在onlyoffice-archive文件夹下新建archive_reminder.py，粘贴完整代码：

import requests
from datetime import datetime, timedelta
配置部分（根据实际修改）
PORTAL_URL = "http://localhost"
ADMIN_EMAIL = "your-admin-email@example.com"
ADMIN_PASSWORD = "your-admin-password"
REMIND_BEFORE_DAYS = 7   提前7天提醒
SMTP_SERVER = "smtp.example.com"   仅需发送邮件时配置
SMTP_PORT = 587
SMTP_USER = "your-sender-email@example.com"
SMTP_PASSWORD = "your-sender-password"
RECIPIENT_EMAILS = ["admin@example.com", "department-head@example.com"]
获取管理员Token
def get_token():
url = f"{PORTAL_URL}/api/2.0/authentication.json"
data = {"email": ADMIN_EMAIL, "password": ADMIN_PASSWORD}
response = requests.post(url, json=data)
return response.json()["response"]["token"]
获取所有带到期日期的档案
def get_expiring_files(token):
url = f"{PORTAL_URL}/api/2.0/files.json"
headers = {"Authorization": f"Bearer {token}"}
params = {"filter": "customFields"}
response = requests.get(url, headers=headers, params=params)
files = response.json()["response"]
expiring_files = []
today = datetime.now().date()
remind_date = today + timedelta(days=REMIND_BEFORE_DAYS)
for file in files:
custom_fields = file.get("customFields", [])
expiry_date_str = None
file_code = None
for field in custom_fields:
if field["label"] == "到期日期":
expiry_date_str = field["value"]
elif field["label"] == "档案编号":
file_code = field["value"]
if expiry_date_str:
try:
expiry_date = datetime.strptime(expiry_date_str, "%Y-%m-%d").date()
if remind_date >= expiry_date >= today:
expiring_files.append({
"name": file["title"],
"code": file_code,
"expiry_date": expiry_date_str,
"link": f"{PORTAL_URL}/Products/Files/DocEditor.aspx?fileId={file['id']}"
})
except ValueError:
continue
return expiring_files
主函数
if __name__ == "__main__":
token = get_token()
expiring_files = get_expiring_files(token)
if expiring_files:
print("即将到期的档案：")
for file in expiring_files:
print(f"编号：{file['code']} | 名称：{file['name']} | 到期日：{file['expiry_date']} | 链接：{file['link']}")
如需发送邮件，可取消以下代码注释
import smtplib
from email.mime.text import MIMEText
subject = f"档案到期提醒（{REMIND_BEFORE_DAYS}天内）"
content = "\n".join([f"- {f['code']}：{f['name']}，到期日：{f['expiry_date']}，链接：{f['link']}" for f in expiring_files])
msg = MIMEText(content, "plain", "utf-8")
msg["Subject"] = subject
msg["From"] = SMTP_USER
msg["To"] = ",".join(RECIPIENT_EMAILS)
with smtplib.SMTP(SMTP_SERVER, SMTP_PORT) as server:
server.starttls()
server.login(SMTP_USER, SMTP_PASSWORD)
server.sendmail(SMTP_USER, RECIPIENT_EMAILS, msg.as_string())

• 配置定时任务：
  • Windows：使用任务计划程序，设置每天早上9点执行python.exe C:\onlyoffice-archive\archive_reminder.py
  • Mac/Linux：终端输入crontab -e，添加0 9 /usr/bin/python3 /root/onlyoffice-archive/archive_reminder.py（路径根据实际修改）