跳至主要內容

服务端部署

Kaipi Lab大约 4 分钟

服务端部署

注意

服务端软件已闭源

AWTRIX可以在任何平台（Windows、macOS、Linux）上运行，唯一的要求是支持Java。但是不太建议运行在个人电脑上，最好是在一台可以长时间工作、不关机的电脑上，如：树莓派、NAS、软路由、服务器、云服务器。

  • 树莓派、服务器、云服务器建议使用Linux脚本安装
  • 软路由和NAS建议使用Docker方式进行安装
  • Windows/macOS安装好java环境，执行即可

Linux脚本安装

提示

安装脚本已切换至阿里云下载地址，速度提升明显

  • 运行环境：JAVA 8
  • 服务端版本：Beta 2028
  • 设备：树莓派4B
  • 云服务商：阿里云
  • 推荐系统：Debian12 Ubuntu22.04

如果你没有SSH工具或者不了解它是啥，请下载Xshell

Xshell下载
阿里云镜像下载

然后输入IP地址，用户名，密码登录至你的设备系统。

在SSH终端中输入以下命令进行自动安装

国内镜像:

  • 最新版服务端一键脚本命令:

wget -N https://kaipi.oss-cn-hangzhou.aliyuncs.com/awtrix/matrix.sh ; sudo sh matrix.sh beta

  • 稳定版服务端一键脚本命令:

wget -N https://kaipi.oss-cn-hangzhou.aliyuncs.com/awtrix/matrix.sh ; sudo sh matrix.sh

德国官方:

  • 最新版服务端一键脚本命令:

wget -N https://blueforcer.de/awtrix/awtrix.sh ; sudo sh awtrix.sh beta

  • 稳定版服务端一键脚本命令:

wget -N https://blueforcer.de/awtrix/awtrix.sh ; sudo sh awtrix.sh

提示

等待安装完成之后，就可以通过提示的IP来打开管理网页： http://服务端IP:7000

修改为中文并重启更新服务端

如何将服务端网页语言设为中文？
本站链接

可以通过以下命令来控制Awtrix服务

  • 启动服务

sudo service awtrix start

  • 停止服务

sudo service awtrix stop

  • 重启服务

sudo service awtrix restart

提示

如果你使用的是root用户，不需要添加 "sudo"

重新运行安装命令即可更新服务端程序，不会影响之前配置

Windows/macOS安装

注意

  • 因Java不支持windows7以下操作系统，如果版本较低，请先进行升级
  • 请使用Java的在线安装包，否则可能无法正常运行。
  • 如果觉得太麻烦请尝试使用Docker方式安装，也比较方便。
JAVA运行环境下载
Java官方
服务端最新版程序下载
阿里云节点
服务端稳定版程序下载
阿里云节点

提示

服务端程序已切换至阿里云下载地址，速度提升明显

注意

最新版可能导致问题，当出现问题时,可以尝试使用稳定版

  1. 创建文件夹，将jar包放入文件夹里（打开的时候会生成文件）

  2. 运行java程序

    1. Windows：
      1. 双击运行awtrix.jar文件，观察文件夹有没有创建文件，创建完成即代表可以正常使用
      2. 如果没有安装成功请尝试使用macOS的操作方式
    2. macOS：
      1. 打开终端
      2. cd /放置jar文件的路径
      3. sudo java -jar awtrix.jar

  3. 打开浏览器，在地址栏输入127.0.0.1:7000

  4. 正常显示网页即表示安装成功

Docker安装

提示

  • 推荐使用群晖Docker或者x86软路由Docker,ARM版的Docker稳定性略差。

  • 建议设备在出国的环境下，使用OpenClash的请使用Fake-ip模式，不在的话下载速度会比较慢

注意

首先查看您的设备上是否已经有Docker，如果没有请先进行安装,不知道如何安装可以选择已经带有Docker的固件

Awtrix官方 Dockerhub仓库地址
德国服务器，下载速度较慢，需注意

docker命令

注意

  • 注意你设备的架构，正常电脑是x86，我们选择AMD64。
  • 如果你用的是苹果M1、M2芯片，或者使用的是ARM的软路由，或者手机，或者树莓派等等，请选择ARM64。

x86 Docker安装命令

docker run -d --name awtrix2 -p 7000:7000 -p 7001:7001 -p 5568:5568/udp --restart always -e TZ=Asia/Shanghai -v /path:/data whyet/awtrix2:latest

ARM64 Docker安装命令

docker run -d --name AwTriX2 -p 7000:7000 -p 7001:7001 -p 5568:5568/udp --restart always -e TZ=Asia/Shanghai -v /path:/opt whyet/awtrix2:latest-arm64

####环境变量（Environment variables）

部分可以在启动前做的设定

-e AWTRIX_BETA=true

BETA版本打开，关闭=false

-e AUTOUPDATE=true

自动升级打开，关闭=false

-e JAVA_TOOL_OPTIONS="-Duser.language=de -Duser.country=DE"

设置国家和语言。

Docker Compose安装

version: "3"

services:
  awtrix:
    image: whyet/awtrix2
    restart: unless-stopped
    ports:
      - "7000:7000"
      - "7001:7001"
      - "5568:5568"
   
    volumes:
      - ./data:/data
      - /sys/class/net/<your interface>/address:/data/hostmac
    environment:
      - TZ=Asia/Shanghai
      - JAVA_TOOL_OPTIONS="-Duser.language=zh -Duser.country=CN"
      - AWTRIX_BETA=false
      - AUTOUPDATE=true
Copyright © 2024 Kaipi Lab