README_CN.md

En 中文

iDataRiver Theme(Basic)

本项目是由iDataRiver平台开源的独立站项目。

网站的项目/商品管理请前往iDataRiver平台的控制台->项目管理进行操作。

商户入驻指南 / 演示 Demo / 反馈 Issues

项目交流

• Telegram商户群: https://t.me/idatariver_merchant
• Discord频道: https://discord.gg/Ag7EUvhub5

特点

基于iDataRiver的后端能力提供支持

本独立站与iDataRiver平台的商户开放API对接, 因此可直接使用iDataRiver提供的数据+支付+风控+安全等各项能力。

商户只需要在控制台做好配置即可直接使用，不需要自己去面对复杂且成本高昂的底层实现。

SEO优化

独立站使用SSR(服务端渲染)技术, 因此搜索引擎能更好的索引网站关键词。

高度灵活的自定义脚本支持

商户可直接在后台添加自定义JS脚本, 大幅增加功能灵活性。

自动支持全球多国语言翻译

不仅独立站本身支持多语言，还默认支持将项目/商品描述智能翻译成18种语言，让你的业务真正全球化。

一级代理商功能

独立站前端完全兼容平台商户的代理商功能, 详细介绍可见文档。

提供基础的API加密

本模板提供基础的API签名加密功能，也支持商户自定义签名密钥，有效增加逆向/ddos等攻击门槛。

二次开发

对于开发者，可自行对接商户开放API进行二次开发。

部署

使用Docker部署

下载镜像

docker pull idatariver/theme-basic:latest

运行容器, NUXT_IDATARIVER_MERCHANT_SECRET需要设置为自己的部署密钥

docker run --name idatariver -d --restart=always --publish 3000:3000 -e NUXT_IDATARIVER_MERCHANT_SECRET=dp_*** idatariver/theme-basic

使用Vercel部署

本项目基于Nuxt3开发，可在如Vercel这类主流的网站托管平台上直接部署上线。

如果你没有任何部署经验，可选择快速部署方案。

如果你有一定部署经验，可按如下步骤手动部署:

1. 将本项目fork到自己的Github账号下

2. 注册一个Vercel账号，绑定步骤1的Github账号，并授权访问fork的本项目

Vercel账号需要绑定你的手机号，你可以使用我们的短信接码服务来保护自己的隐私。

3. 在Vercel控制台创建一个新项目，导入步骤2的项目:

在Vercel上创建项目

添加项目访问权限

导入要部署的项目

开始部署项目，并设置以下的环境变量:

NUXT_IDATARIVER_MERCHANT_SECRET

部署密钥，此参数必须填写，可在iDataRiver平台控制台的商户设置 -> 独立站 里配置后获取。

NUXT_PUBLIC_API_ENCRYPT_KEY

可选参数，用于自定义API层面的加密签名，从而获得更好的安全保护，可以自行设置其值。

以上环境变量设置好之后，点击Deploy进行部署，等待一分钟左右你的商户独立站就能部署成功。

4. 绑定域名

如果你还没有域名，强烈建议使用iDataRiver提供的域名注册服务，完全保护你的隐私。

部署成功后，点击项目右上角的Domains(域名)入口，按照指定操作即可。

添加你的域名:

最后，给域名添加对应的DNS解析记录即可。

使用CloudFlare托管域名

如果使用CloudFlare免费托管域名，则需要如下配置:

添加Vercel要求的DNS解析记录后(代理模式)

将域名的SSL/TLS设置为完全端到端加密

5. 最后

至此，你的独立站已成功部署上线。

如果一段时间后需要升级到最新版本，有以下两种方式:

1. 在Vercel里将原先的项目删除，然后重新按照上面的步骤进行操作一遍。

2. 将你在Github上fork的本项目手动Sync同步，然后在Vercel里手动触发一次部署即可。