1购买：服务器与产品
两件事：买一台你自己的服务器（产品跑在上面），买产品授权（激活码）。顺序无所谓，但建议先买服务器，拿到激活码后直接装。
选购服务器（推荐腾讯云）
Yof 家族自托管产品都是单机应用（Node + SQLite + Nginx），配置要求不高。按团队规模二选一即可，轻量应用服务器性价比最高：
| 规模 | 推荐配置 | 系统 | 带宽 | 说明 |
|---|---|---|---|---|
| 起步（1–10 人）推荐 | 轻量应用服务器 2核 4G | Ubuntu 22.04 / Debian 12 | ≥ 3 Mbps | YofCRM / YofMail 单机足够，约 60G SSD |
| 成长（10–50 人） | 轻量应用服务器 4核 8G | Ubuntu 22.04 / Debian 12 | ≥ 5 Mbps | 附件量大或加 WhatsApp 归档时选它 |
| 海外团队 | 任选海外区域（香港 / 新加坡 / 硅谷） | 同上 | ≥ 5 Mbps | 客户主要在欧美就选近客户端的区域，无需国内备案 |
2服务器初始化
新服务器到手后花 5 分钟做四件事：系统、端口、更新、时区。做完这些，安装脚本就是一条命令的事。
四步初始化
- 装系统：重装为 Ubuntu 22.04（或 Debian 12），64 位。重装会清空磁盘，请在购买时选好或确认无数据。
- 开放端口：在云控制台的「防火墙 / 安全组」放行 80（HTTP）与 443（HTTPS）；如仅先测试可只开 22（SSH）。（图示见下，安全组规则是独立开关，服务器内的防火墙不会自动同步）
- SSH 登录并更新：
ssh root@你的服务器IP→apt update && apt upgrade -y - 校准时区：
timedatectl set-timezone Asia/Shanghai（订单与证书有效期按服务器时间判断，时区错乱会导致误判「证书即将过期」）。
| 类型 | 来源 | 端口 | 策略 | 备注 |
|---|---|---|---|---|
| TCP | 0.0.0.0/0 | 22 | 允许 | SSH 远程管理 |
| TCP | 0.0.0.0/0 | 80 | 允许 | HTTP · 证书申请与跳转 |
| TCP | 0.0.0.0/0 | 443 | 允许 | HTTPS · 站点访问 |
▲ 云控制台防火墙（安全组）：80 与 443 必须放行，否则安装末步的 HTTPS 证书申请会失败
3部署安装（一条命令）
不用上传任何文件、不用编译：控制台给你生成一条命令，复制到服务器执行，7 步自动完成安装。
安装命令从哪来
- 打开控制台：yofmo.com/dashboard → 登录 → 左侧「安装」（在对应产品的壳内）。
- 填你的域名：例如
crm.你的域名.com（需已解析到本服务器 IP）。 - 复制命令执行：海外服务器用 INTL 版；中国大陆服务器用 CN 版（自动走国内 npm 镜像，更快）。
- 等待 3–10 分钟：脚本自动完成依赖安装、建库、起服务、申请 HTTPS 证书。
▲ 控制台「安装」页：填域名 → 生成 → 复制命令（密钥与域名已内嵌，无需手动拼接）
▲ 服务器上的执行输出：七步全绿即完成，末尾会给出访问地址与初始管理员账号
4激活授权
用控制台生成的命令安装，授权会自动完成——无需再手动输入激活码。只有从其他渠道拿到激活码（或换机器重装）时才需要手动绑定。
三种情形怎么办
- 正常安装：命令安装即自动激活，产品页「设置 → 授权」显示运行中。无需操作。
- 手动绑定激活码：控制台 →「授权管理」→ 输入激活码 → 绑定并激活。适用于在已装好的机器上补绑。
- 换服务器重装：旧机器不再使用时直接在新机器安装即可（同产品码自动解绑旧机重绑，有换绑额度与 24 小时冷却，异常顶替会留痕）。
▲ 手动绑定入口（自动激活的用户无需此步）；服务期与升级状态也在此查看
5存储配置（附件 / 图片放哪）
系统本身用服务器本地磁盘；报价附件、产品图片等建议外接对象存储，换机不丢、备份省心。四种后端任选，也可先用本地磁盘跑起来再迁。
四种对象存储后端
| 后端 | 适合谁 | 费用量级 | 说明 |
|---|---|---|---|
| 腾讯云 COS国内推荐 | 国内团队 | 约 ¥0.1–0.15/GB/月 | 与服务器同区域，内网上传免流量费 |
| 阿里云 OSS | 国内团队（已有阿里云） | 约 ¥0.12/GB/月 | 同上，按已有云生态选 |
| Cloudflare R2 | 海外团队 | $0.015/GB/月，零出口费 | YofMo 自家同款方案，海外访问最快 |
| MinIO 自建 | 数据必须完全自持 | 仅占用服务器磁盘 | 装在本机或另一台内网机器，运维成本略高 |
▲ 产品后台「设置中心 → 插件（对象存储）」：COS / OSS / R2 均为 S3 兼容，填法一致
6账号创建
管理员账号在安装时自动建好；团队成员账号由管理员在产品后台自行创建，无需再到平台操作。
两步走
- 管理员（安装时自动完成）：账号为
admin@你的域名.com，初始密码在安装输出的末尾——首次登录强制修改。 - 团队成员：用管理员登录产品后台 →「用户 / 成员管理」→ 新建账号，分配角色（如销售、生产、财务）即可开始使用。
| 成员 | 邮箱 | 角色 | 状态 |
|---|---|---|---|
| 管理员 | admin@你的域名.com | ADMIN | 启用 |
| 王销售 | sales@你的域名.com | SALES | 启用 |
| 李生产 | prod@你的域名.com | PRODUCTION | 启用 |
▲ 产品后台用户管理：建成员、分角色，全在你自己服务器上完成
7产品内设置（以 YofCRM 为例）
系统能打开、能上传之后，下面是管理员最常用的五类设置。都在产品后台的「系统设置」里，按要做的事逐条来即可。
① 连接即时沟通（WhatsApp）
系统设置 → 集成 → WhatsApp 自动化。业务员已有独立凭据的，在「凭据」页确认谁已绑定；用系统统一通道的，填 WAHA 地址与 API 密钥——国内服务器记得开「镜像加速 / 代理」，否则连不上。保存后客户 WhatsApp 消息自动归档进客户时间线，并可被 AI 提炼分发给对应业务员。
② 配置邮箱（让系统能发邮件）
系统设置 → 邮件（SMTP）：打开「启用邮件服务」，填服务商给的 SMTP 主机（如 smtp.qq.com）、端口 465/587、用户名与授权码、发件人。保存后系统可发邀请与通知邮件，客户回信也会自动关联进客户档案。
③ 配置 AI 能力
系统设置 → AI 设置：选服务商（自动填入推荐模型与接口地址），粘贴你申请的 API 密钥，先点「测试当前配置是否可用」再保存。保存后客户分析、跟进建议、名片识别、智能搜客等 AI 功能即可用。
④ 集成能力（对象存储 / Webhook / 钉钉）
- 对象存储：见第 5 节，决定附件存哪里（COS / OSS / R2 / MinIO）。
- Webhook：把新建客户、成交订单等关键事件推送到你自己的系统，填回调地址 + 鉴权令牌。
- 钉钉机器人：把重要提醒推到钉钉群，填 Webhook 地址后先「发送测试消息」验证连通。
⑤ 配置字段（按业务自定义）
系统设置 → 字段管理：选业务对象（客户 / 订单 / 线索等），可新增、删除字段，调整显隐与排序，保存后对全员立即生效。给错角色或字段随时可改，历史数据不受影响。
8常见问题
安装到第 7 步卡住 / 证书申请失败？＋
九成是域名没解析到本机，或云控制台防火墙没放行 80/443。检查 ping 你的域名 是否等于服务器 IP，并确认防火墙两条规则都在。修好后回控制台重新生成命令再装（密钥一次性，重装会发新密钥）。
安装命令能转发给别人用吗？＋
不能。命令内嵌一次性密钥：第一次成功下载安装包后立即作废，他人拿到旧命令会得到「密钥已使用」。要帮朋友装，请各自在控制台生成。
换服务器 / 重装会丢数据吗？＋
同一台机器重装会保留数据库与配置文件（不覆盖既有数据）。换新机器请先备份 /opt/yofcrm/data/ 目录与对象存储里的文件，再在新机安装后恢复。
忘记管理员密码怎么办？＋
服务器上执行安装目录下的管理员种子脚本可重置：cd /opt/yofcrm/apps/api && node prisma/seed/admin-init.mjs（不给密码参数会随机生成一个新密码并打印，随后强制改密）。