本地部署软件新手入门指南：部署前必须搞清楚的6件事

本地部署软件，不是买一台服务器、把系统装好就结束。真正决定项目能否顺利上线的，往往是部署前的六个判断：为什么部署、跑在哪里、数据怎么迁移、权限怎么管、故障怎么恢复、成本由谁承担。把这六件事写成可验收的清单，比急着装环境更有价值。

以禅道项目管理软件为例，它同时提供私有化部署和云禅道两种形态。选择私有化，意味着企业要接过环境、数据和安全的主要责任。禅道官方使用手册显示，产品包含 274 个功能模块、2265 个功能点。功能范围越大，越需要在部署前圈定首期边界，而不是一次全部上线。

一、部署目标：先回答“为什么放在本地”

本地部署的常见理由有三类：数据要留在指定网络、系统要对接内部流程、配置要按自身业务调整。三类理由对应的工作量不同。只为数据留存，重点在边界和审计；要做深度集成，重点在接口和测试；要做大量定制，重点在升级兼容和长期维护。

把目标写成一句话，再补三个约束：首批使用哪些部门、哪些流程必须上线、什么结果算成功。比如“让研发、测试、产品三个团队在一个系统里完成需求到 Bug 的闭环，首批 200 人，三个月内上线”。没有这几个数字，部署范围会被不断放大。

这一节的交付物是一页部署说明：目标、首批用户、数据范围、必须集成的系统、验收指标、明确不做的内容。它会在后面每一个争议里充当判断依据。

二、运行环境：最低配置不等于生产配置

本地部署软件的运行环境，要落到五层：服务器与存储、操作系统与 CPU 架构、数据库与中间件、网络与访问入口、浏览器与客户端。每一层都要以当前版本的官方部署文档为准，不能拿旧教程或默认配置直接上生产。

容量不要只按“现在多少人”估算。并发用户、附件增长、日志保留、备份窗口、报表查询都会影响资源。最低配置能装起来，不代表能支撑日常使用。生产环境还要判断是否做高可用、是否需要独立数据库、备份放在哪里。

先搭一套与生产同架构的小环境，完成安装、登录、建项目、传附件、跑报表和一次集成验证。禅道提供 Windows、Linux、Docker 等安装方式，具体版本与依赖应以官方下载页和部署手册为准。把版本号、架构图和端口清单留给运维，后续排障会省很多时间。

三、数据迁移：先盘点，再迁移

迁移不是把旧系统的表导出来。先盘点数据：组织与用户、项目与任务、需求与用例、Bug 与测试记录、文档与附件、操作日志。哪些必须保留，哪些只留归档，哪些可以不带，要在动手前定下来。

然后做字段映射和清洗。旧系统的状态、角色、必填项未必能直接对应新系统。迁移脚本要处理空值、重复用户、失效附件和超长文本。正式迁移前至少完整演练一次，记录耗时、失败项和修复办法。

验收看四件事：记录数量对得上、抽样字段一致、附件能打开、权限没有错位。上线当天设置冻结窗口，旧系统只读，保留回退路径。系统集成同样要验收：账号从哪里来、数据往哪里走、接口失败后怎么补。能登录不等于迁移完成，能查、能改、能追溯才算。

四、账号与权限：本地部署不会自动更安全

数据放在自己的机房，只改变了控制边界，不会自动带来安全。上线前要明确账号来源：是本地账号，还是对接企业统一身份；离职、转岗、外包人员如何及时停用。

权限按角色划分，不按“方便”划分。系统管理员、项目管理员、普通成员、只读访客要分开。高权限账号数量要可控，关键操作要留审计记录。网络侧确认访问范围、端口、TLS 证书和防火墙策略，不要把管理后台直接暴露在公网。

安全还要落到日常动作：补丁跟进、弱口令检查、日志留存、异常登录告警、第三方接入审批。每一项都指定负责人和检查频率。没有责任人的安全要求，通常不会被执行。

五、备份与恢复：备份完成不等于能恢复

先定两个指标：能接受丢多少数据，能接受停多久。它们决定备份频率、保留周期和恢复方式。数据库、附件、配置文件要一起备份，只备数据库会留下恢复缺口。

备份至少保留一份在与生产不同的位置，关键系统可考虑离线或不可篡改副本。备份文件要加密，访问权限要单独管理。更重要的是演练：在测试环境实际恢复一次，核对数据、附件和权限，记录耗时和步骤。

升级前同样要备份，并确认新旧版本的兼容范围。版本升级、备份与恢复的具体操作，以禅道使用手册中对应版本的说明为准。没有恢复演练的备份，只是一份占空间的文件。

六、成本与责任：把长期投入算进来

本地部署的成本不只是一套软件。服务器或云资源、存储、备份介质、实施与迁移、接口开发、安全加固、日常运维、培训和升级，都要进入预算。软件授权可能是一次性，也可能按年订阅；报价口径不同，不能只比首年数字。版本与授权范围可参考禅道价格页。

责任边界要写进实施计划：厂商负责产品问题和版本支持，企业负责网络、服务器、账号和备份，集成商负责哪些接口，业务部门负责哪些数据。每项都要有交付物和验收人。否则出问题时，大家都能说“这不归我”。

还要留出退出方案：数据如何完整导出、合同到期后还能用多久、迁移到其他环境需要什么条件。能进也能出，才算真正掌握主动权。

上线前检查表：六项判断怎么验收

下面这张表可以直接用于部署前评审。每一项都要有明确答案和责任人，不能只写“已确认”。

对本地部署软件来说，这张表把六项判断压缩成可验收的结果。六项里任何一项只停留在口头确认，都建议暂缓上线；先补齐最薄弱的环节，再安排正式部署。