# 📦 程序部署

## Docker 部署

推荐使用 Docker 部署，需预先安装 [Docker 引擎](https://docs.docker.com/engine/install/)，服务器执行命令创建容器：

```bash
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 后台登陆界面。

执行命令创建管理员账户：

```bash
docker exec -it artalk artalk admin
```

在你的网站引入 Artalk 程序内嵌的的前端 CSS、JS 资源并初始化：

> 注：将 `http://your_domain:8080` 改为你的服务器域名，或使用 [公共 CDN 资源](#cdn-资源)。

```html
<!-- 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](./transfer.md)。

🥳 你已成功完成 Artalk 部署！

## 普通方式部署

1. 前往 [GitHub Release](https://github.com/ArtalkJS/Artalk/releases) 下载程序压缩包
2. 提取压缩包：`tar -zxvf artalk_版本号_系统_架构.tar.gz`
3. 运行程序 `./artalk server`
4. 前端配置

    ```js
    Artalk.init({ server: "http://your_domain:23366" })
    ```

**进一步操作：**

- [守护进程 (Systemd, Supervisor)](./backend/daemon.md)
- [反向代理 (Caddy, Nginx, Apache)](./backend/reverse-proxy.md)

如果有需要，你还可以自行编译程序，参考：[后端构建](./backend/build.md)。

## Compose 部署

**compose.yaml**

```yaml
version: "3.5"
services:
  artalk:
    container_name: artalk
    image: artalk/artalk-go
    restart: always
    ports:
      - 8080:23366
    volumes:
      - ./data:/data
```

执行命令创建容器：

```bash
docker-compose up -d
```

::: details 一些 Docker Compose 常用命令

```bash
docker-compose restart  # 重启容器
docker-compose stop     # 暂停容器
docker-compose down     # 删除容器
docker-compose pull     # 更新镜像
docker-compose exec artalk bash # 进入容器
```

:::

可参考：[Docker 部署文档](./backend/docker.md)

## 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 (国内)**

> https://lib.baomitu.com/artalk/:ArtalkVersion:/Artalk.js
>
> https://lib.baomitu.com/artalk/:ArtalkVersion:/Artalk.css

**UNPKG**

> https://unpkg.com/artalk@:ArtalkVersion:/dist/Artalk.js
> 
> https://unpkg.com/artalk@:ArtalkVersion:/dist/Artalk.css

**JS DELIVR**

> https://cdn.jsdelivr.net/npm/artalk@:ArtalkVersion:/dist/Artalk.js
> 
> https://cdn.jsdelivr.net/npm/artalk@:ArtalkVersion:/dist/Artalk.css

:::

## Node 项目

```bash
pnpm add artalk
```

引入到你的项目：

```js
import 'artalk/dist/Artalk.css'
import Artalk from 'artalk'

Artalk.init({
  // ...
})
```

可参考：

- [置入框架文档](./frontend/import-framework.md)
- [置入博客文档](./frontend/import-blog.md)
- [前端 API](../develop/fe-api.md)

## 数据导入

从其他评论系统导入数据：[数据迁移](./transfer.md)

## ArtalkLite

可选择精简版 [ArtalkLite](./frontend/artalk-lite.md)：体积更小、更简约。

## 开发环境

可参考：[开发者指南](https://github.com/ArtalkJS/Artalk/blob/master/CONTRIBUTING.md)