商标数字档案馆系统本地部署全流程实操落地指南

一、前置准备

1. 硬件与环境要求

请准备一台至少2核4G内存的服务器，系统为Ubuntu Server 22.04 LTS，操作环境为Linux终端，确保可以正常访问公网。

2. 安装Docker与Docker-compose

打开终端，依次执行以下命令完成安装：

``` sudo apt update sudo apt install docker.io docker-compose -y ```

验证安装成功，执行命令：

``` docker --version docker-compose --version ```

若输出版本号则安装成功，若失败请检查网络连接。

二、系统部署实操

1. 新建部署目录

执行命令创建部署目录并进入：

``` sudo mkdir -p /home/trademark-archive && cd /home/trademark-archive ```

2. 编写docker-compose配置文件

执行命令创建并编辑配置文件：

``` sudo nano docker-compose.yml ```

将以下完整内容粘贴到编辑窗口，按Ctrl+O、回车保存，再按Ctrl+X退出：

``` version: '3.8' services: trademark-archive: image: registry.cn-hangzhou.aliyuncs.com/trademark-digital/archive:latest container_name: trademark-archive ports: - "8080:8080" volumes: - ./data:/app/data environment: - SPRING_PROFILES_ACTIVE=prod restart: always ```

重点提示：请勿修改配置文件中image的地址，否则无法拉取合法镜像。

3. 拉取并启动服务

执行命令拉取系统镜像并启动服务：

``` sudo docker-compose pull sudo docker-compose up -d ```

执行完成后等待60秒再进行后续操作，确保容器完成初始化。

三、初始登录与基础配置

1. 首次登录系统

在浏览器中访问地址：http://服务器公网IP:8080（本地测试请用http://localhost:8080），进入登录页面，输入默认账号：admin，默认密码：Admin@123，点击登录。

2. 修改默认管理员密码

登录后会自动跳转至密码修改页面，新密码需满足8-20位，包含大小写字母、数字及特殊字符，输入两次新密码后点击提交，完成密码修改。

3. 导入商标分类数据

进入左侧菜单“系统设置-数据管理-商标分类”，点击“导入”按钮，选择目录./data/csv下的商标分类文件（若没有可执行命令下载：sudo wget https://static.techguide.com/trademark-class.csv -P ./data/csv/），确认导入后等待10秒，完成商标分类数据加载。

四、核心功能实操

1. 上传商标档案

进入左侧菜单“档案管理-上传档案”，点击“选择文件”，仅支持pdf、jpg、png格式，单文件大小不超过100MB，选择商标注册证文件后点击“上传”，系统自动解析商标名称、注册号、申请日期等字段，解析完成后可在档案列表中查看。

2. 查询与下载商标档案

进入左侧菜单“档案查询”，输入商标注册号或商标名称，点击“查询”，结果列表会显示匹配的档案信息；点击“查看详情”可获取完整档案内容，点击“下载”可导出为本地PDF文件。

五、常见问题排查

1. 无法访问系统

先检查容器是否运行，执行命令：

``` sudo docker ps | grep trademark-archive ```

若无输出，执行启动命令：sudo docker-compose up -d；若有输出，检查服务器防火墙是否开放8080端口，执行命令：sudo ufw allow 8080。

2. 档案解析失败

执行命令查看容器日志，定位解析错误：

``` sudo docker logs trademark-archive --tail 50 ```

常见原因是文件格式不支持或内容过杂，需上传清晰的标准格式文件。