qwqcode
bad248534c
BREAKING CHANGE: The following top-level functions exported by the 'artalk' npm package have been deprecated: `Artalk.update`, `Artalk.reload`, and `Artalk.destroy`. These methods now require invocation on an instance created by either `Artalk.init` or `new Artalk`. Please utilize instance-level methods instead, such as `artalkInstance.update`. For more information, refer to [the documentation](https://artalk.js.org/guide/frontend/import-framework.html). The update was implemented to enable the concurrent creation of multiple instances, adapting to situations where Vue components are simultaneously referenced across various pages. Initially, only a singular instance was permitted to mitigate memory leak concerns. However, this proved limiting for scenarios involving the caching of multiple component instances through 'keep-alive.' To better suit intricate SPA application needs, the choice was made to permit the creation of multiple independent instances. It's crucial to remember to manually invoke the `artalk.destroy` method when releasing components to avoid memory leaks (Issue #660).
4.7 KiB
📦 程序部署
Docker 部署
推荐使用 Docker 部署，需预先安装 Docker 引擎，服务器执行命令创建容器：
docker run -d \
--name artalk \
-p 8080:23366 \
-v $(pwd)/data:/data \
--restart=always \
artalk/artalk-go
假设域名
http://your_domain已正确添加 DNS 记录并指向你的服务器 IP
浏览器打开 http://your_domain:8080 将出现 Artalk 后台登陆界面。
执行命令创建管理员账户：
docker exec -it artalk artalk admin
在你的网站引入 Artalk 程序内嵌的的前端 CSS、JS 资源并初始化：
注：将
http://your_domain:8080改为你的服务器域名，或使用 公共 CDN 资源。
<!-- CSS -->
<link href="http://your_domain:8080/dist/Artalk.css" rel="stylesheet">
<!-- JS -->
<script src="http://your_domain:8080/dist/Artalk.js"></script>
<!-- Artalk -->
<div id="Comments"></div>
<script>
Artalk.init({
el: '#Comments', // 绑定元素的 Selector
pageKey: '/post/1', // 固定链接 (留空自动获取)
pageTitle: '关于引入 Artalk 的这档子事', // 页面标题 (留空自动获取)
server: 'http://your_domain:8080', // 后端地址
site: 'Artalk 的博客', // 你的站点名
})
</script>
在评论框输入管理员的用户名和邮箱，控制台入口按钮将出现在评论框右下角位置。
在控制台，你可以根据喜好配置评论系统、将评论迁移到 Artalk。
🥳 你已成功完成 Artalk 部署！
普通方式部署
-
前往 GitHub Release 下载程序压缩包
-
提取压缩包：
tar -zxvf artalk_版本号_系统_架构.tar.gz -
运行程序
./artalk server -
前端配置
Artalk.init({ server: "http://your_domain:23366" })
进一步操作：
如果有需要，你还可以自行编译程序，参考：后端构建。
Compose 部署
compose.yaml
version: "3.5"
services:
artalk:
container_name: artalk
image: artalk/artalk-go
restart: always
ports:
- 8080:23366
volumes:
- ./data:/data
执行命令创建容器：
docker-compose up -d
::: details 一些 Docker Compose 常用命令
docker-compose restart # 重启容器
docker-compose stop # 暂停容器
docker-compose down # 删除容器
docker-compose pull # 更新镜像
docker-compose exec artalk bash # 进入容器
:::
可参考：Docker 部署文档
CDN 资源
::: tip Artalk 最新版本
当前 Artalk 前端最新版本号为： :ArtalkVersion:
若需升级前端，请将 URL 中的版本号数字部分替换即可。 :::
Artalk 后端程序内嵌了前端 JS、CSS 文件，使用公共 CDN 资源请注意前后端版本的兼容性。
Artalk 静态资源通过上游 CDNJS 分发，以下镜像资源可供选择：
CDNJS
https://cdnjs.cloudflare.com/ajax/libs/artalk/:ArtalkVersion:/Artalk.js
https://cdnjs.cloudflare.com/ajax/libs/artalk/:ArtalkVersion:/Artalk.css
Staticfile CDN (国内)
https://cdn.staticfile.org/artalk/:ArtalkVersion:/Artalk.js
https://cdn.staticfile.org/artalk/:ArtalkVersion:/Artalk.css
::: details 查看更多
BootCDN (国内)
https://cdn.bootcdn.net/ajax/libs/artalk/:ArtalkVersion:/Artalk.js
https://cdn.bootcdn.net/ajax/libs/artalk/:ArtalkVersion:/Artalk.css
75CDN (国内)
UNPKG
JS DELIVR
https://cdn.jsdelivr.net/npm/artalk@:ArtalkVersion:/dist/Artalk.js
https://cdn.jsdelivr.net/npm/artalk@:ArtalkVersion:/dist/Artalk.css
:::
Node 项目
pnpm add artalk
引入到你的项目：
import 'artalk/dist/Artalk.css'
import Artalk from 'artalk'
Artalk.init({
// ...
})
可参考：
数据导入
从其他评论系统导入数据：数据迁移
ArtalkLite
可选择精简版 ArtalkLite：体积更小、更简约。
开发环境
可参考：开发者指南