| 项目 | 要求 |
|---|---|
| fnOS 版本 | 1.1.3100 及以上（使用系统域名访问与登录态校验需要） |
| 硬件架构 | x86_64 或 arm64 |
| 运行时 | Node.js 22。使用 fnOS 应用包时由依赖自动提供，无需手工安装 |
| Docker 环境 | Docker Engine 20.10 及以上，Compose v2（镜像需先联系我们获取） |
| 权限 | 安装与卸载需要管理员权限 |
| 端口 | 默认 3000，安装时可自定义 |
| 磁盘空间 | 建议预留 1 GB 以上，用于业务数据与自动快照 |
| 工作线程数 | 默认 4，可在后台调节 1–16；设置后需重启应用生效 |
| 外部服务 | 不需要数据库或缓存服务；如需邮件通知，另需一个可用的 SMTP 邮箱 |
从应用中心安装，或使用随附的 .fpk 文件手动安装。手动安装仅建议用于本地验证。
# 从本地文件安装（含向导的应用可指定环境变量文件） $ appcenter-cli install-fpk TechShop-shop-v1.0.030.fpk # 或直接在当前项目目录安装，命令内部会完成打包 $ appcenter-cli install-local
安装向导分两步：先选择数据存储位置与服务端口，再设置管理员密码。
使用默认位置时数据落在应用的持久化目录；选择自定义路径时，
请填写以 / 开头的绝对路径，例如 /vol1/1000/ShopData。
密码留空、两次填写不一致或少于 6 位时会自动跳过，之后可在应用内补设，不会卡住安装； 服务在密码就位之后才开始监听，不存在「先能进后台、再补密码」的窗口期。 若不确定数据位置该选哪项，直接用默认位置即可，之后可在应用设置中调整。
从桌面打开「TechShop 管理后台」，首次进入会显示使用向导， 依次设置站点名称、收款方式与示例内容。向导底部有 「全部跳过，直接进入后台」，想自己配的话可以一步跳过。
收款码需要你自己上传：应用包里不预置任何收款码， 避免第三方店主的货款误入他人账户。未上传时前台会提示「收款码暂未设置」，不会出现破图。
检查以下三项，确认一切正常后再开始录入商品。
卸载向导中可选择是否保留数据。选择保留时，用户、商品、订单与收款码等数据都会留在原处， 重新安装后仍可继续使用。
# 查看已安装应用与运行状态 $ appcenter-cli list $ appcenter-cli status shop # 手动启停 $ appcenter-cli start shop $ appcenter-cli stop shop
Docker 部署方式包含镜像与编排文件，不随应用包公开发布。 需要时请加微信说明用途与目标环境，我们会提供对应的版本。
| 项目 | 说明 |
|---|---|
| 目标平台 | 群晖 / 威联通 / Unraid / 自建 Linux 等 |
| 设备架构 | x86_64 或 arm64 |
| 用途 | 自用经营、测试评估或其它 |
| 预计商品量 | 便于判断是否需要额外建议 |
# 编排文件与数据目录按实际情况调整 $ mkdir -p techshop/data && cd techshop $ docker compose up -d $ docker compose logs -f shop # 升级：替换镜像标签后重新拉起 $ docker compose pull && docker compose up -d
这通常是升级时旧进程没有被停掉，系统仍在运行上一版代码。 TechShop 已在启动脚本中比对「已安装版本」与「上次启动记录的版本」， 两者不一致会先停后起。若仍遇到，请手动停止再启动一次应用。
fnOS 应用包在安装时不会对端口做静态预检，因此所选端口可能已被其它服务占用。 请在应用设置中改用其它端口，或在设备上确认当前端口占用情况后重启应用。
在飞牛 fnOS 上可通过桌面提供的密码恢复入口重置：系统会校验你的 fnOS 登录态与归属账号， 通过后即可设置新的管理密码。若已开启「禁止密码恢复」，需先由已登录的管理员在后台关闭该限制。
出于安全考虑，系统域名下的后台地址默认被封堵，后台只接受局域网入口访问。
请通过桌面图标打开，或直接访问 http://<主机IP>:<端口>/admin。
自定义数据路径时，请确认该路径存在、且应用运行用户对其具备写权限。 使用 Docker 部署时，还需确认宿主机目录已正确挂载进容器。
在后台的邮件设置中检查服务器地址、端口与授权码，并使用内置的连接测试功能验证。 多数邮箱服务商要求使用「授权码」而非登录密码，请确认填写的是正确凭据。
可以。两者数据格式一致，把 Docker 挂载目录中的业务数据复制到应用的数据目录， 重启应用即可。迁移前建议先停掉一侧服务，避免两边同时写入。
Docker 镜像与编排文件不随应用包公开发布。请通过微信说明目标平台与设备架构， 我们会提供对应版本。详见联系我们。
默认值 4 适合绝大多数设备。该项控制文件读写、加密与压缩的并行度， 调高会占用更多 CPU 与内存，设备核数较少时不必调高。 修改后需要重启应用才会生效。
从 1.0.029 起，数据写入改为先写临时文件再原子改名， 因此不会留下写了一半的文件。若数据文件本身解析失败， 系统会回退到最近一次可用的快照。
应用包中不预置任何收款码。预置的话，第三方店主的货款会默认打进别人账户， 所以请自行在后台「系统设置 → 收款方式」上传你的微信与支付宝收款码。 未上传时前台会显示「收款码暂未设置，请联系管理员」，不会出现破图。
把密码放在安装向导里设，是为了避免「装完到设密码之间」那段空窗期。 密码在应用开始监听端口之前就已就位，也不会写进配置文件或环境变量 —— 应用读取后立即删除临时文件。