龙虾的知识分享站

欧卡专用服务器安装教程（Linux）

Fri, 04 Sep 2026 00:00:00 GMT

本教程带你在一台 Linux 云服务器上，从零搭建属于自己的欧洲卡车模拟 2（ETS2）专用服务器，邀请好友一起联运。

安装 SteamCMD#

创建一个名为 ets-server 的用户并设置密码：

Terminal window

1
useradd -m ets-server   # 创建用户 s1
2
passwd ets-server      # 设置用户 s1 的密码

切换到 s1 用户：

Terminal window

1
su - ets-server

创建 Steam 目录并进入：

Terminal window

1
mkdir ~/Steam   # 创建 Steam 文件夹
2
cd ~/Steam      # 切换到 Steam 文件夹

Centos:#

安装 SteamCMD 运行依赖：

Terminal window

1
yum install glibc.i686 libstdc++.i686 -y

下载并解压 SteamCMD：

Terminal window

1
curl -sqL "https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz" | tar zxvf -

运行 SteamCMD（首次启动会自动更新）：

Terminal window

1
./steamcmd.sh

Ubuntu:#

安装 SteamCMD 运行依赖：

Terminal window

1
sudo add-apt-repository multiverse   # 64位Ubuntu官方apt源不提供SteamCMD，先启用社区维护的软件源
2
sudo dpkg --add-architecture i386   # 启用对32位软件包的支持
3
sudo apt update # 更新apt源

安装 SteamCMD：

Terminal window

1
apt install steamcmd -y    # 安装SteamCMD

安装欧卡专用服务器#

在 SteamCMD 中执行以下命令：

Terminal window

1
force_install_dir ./ets2_server/   # 设置欧卡专用服务器安装路径
2
login anonymous                # 匿名登录 SteamCMD
3
app_update 1948160             # 安装欧卡专用服务器
4
quit                           # 退出 SteamCMD

创建库链接#

Terminal window

1
mkdir ~/.steam/sdk64/   # 新建 sdk64 文件夹
2
ln -s ~/Steam/linux64/steamclient.so ~/.steam/sdk64/steamclient.so   # 创建库链接

生成欧卡主目录#

首次启动欧卡专用服务器，生成欧卡主目录：

Terminal window

1
cd ~/Steam/ets2_server/bin/linux_x64/ && ./server_launch.sh

因欧卡服务器主目录缺少运行所必需的 server_packages 文件而终止运行并退出，是正常现象。

生成 server_packages 文件#

回到本地电脑：

关闭欧卡
打开文件资源管理器，进入 文档\Euro Truck Simulator 2\ 目录
用记事本打开 config.cfg 文件

找到以下两项并修改：

1
uset g_console "0"   →   uset g_console "1"
2
uset g_developer "0" →   uset g_developer "1"

保存修改后，启动欧卡，按 ~（键盘左上角波浪键）呼出控制台，输入命令 export_server_packages 回车，即可生成 packages 文件。

上传 server_packages 文件#

选中 server_packages.sii 和 server_packages.dat 两个文件，拖拽到 WindTerm 文件管理器的 /home/ets-server/.local/share/Euro Truck Simulator 2/ 目录下。

配置 server_config 文件#

在 /home/ets-server/.local/share/Euro Truck Simulator 2/ 目录下编辑 server_config.sii：

1
SiiNunit
2
{
3
server_config : _nameless.51c.1b40 {
4
 lobby_name: "一个欧卡服务器"            # 服务器房间名称
5
 description: "欢迎加入一个欧卡服务器"           # 房间描述
6
 welcome_message: "欢迎来到欧卡服务器" # 玩家进入房间收到的系统欢迎消息
7
 password: ""                          # 房间密码
8
 max_players: 128                       # 房间最大玩家数量（暂时最大 128 人）
9
 max_vehicles_total: 100
10
 max_ai_vehicles_player: 50
11
 max_ai_vehicles_player_spawn: 30
12
 connection_virtual_port: 100
13
 query_virtual_port: 101
14
 connection_dedicated_port: 27015     # 服务器连接端口
15
 query_dedicated_port: 27016          # 服务器查询端口
16
 server_logon_token: "下方生成的 token 字符串" # Steam 游戏服务器账户令牌（作用：房间 ID 固定不变）
17
 player_damage: true                  # 玩家之间的碰撞伤害 true 开 false 关
18
 traffic: true                        # AI 车辆 true 开 false 关
19
 hide_in_company: false               # 货站隐藏玩家？true 开 false 关
20
 hide_colliding: true
21
 force_speed_limiter: false           # 强制卡车限速器 true 开 false 关
22
 mods_optioning: false                # 可选 MOD true 开 false 关
23
 timezones: 0                         # 时区，暂不可用
24
 service_no_collision: false          # 服务站内没有碰撞 true 开 false 关
25
 in_menu_ghosting: false              # 玩家在菜单状态时无碰撞 true 开 false 关
26
 name_tags: true                       # 显示玩家昵称
27
 friends_only: false                  # 仅限 STEAM 好友（专用服务器不可用）
28
 show_server: true                     # 在联运列表显示你的服务器
29
 moderator_list: 1                      # 主持人列表
30
 moderator_list[0]: 76561199259665520
31
}
32

33
}

展开收起

server_logon_token#

前往 Steam 游戏服务器账户管理，填入 App ID 227300，生成 token 使房间 ID 固定不变。

主持人列表#

前往 Steam 个人资料 → 编辑个人资料 → 自定义 URL，删除自定义内容即可看到 Steam 账户 ID。

主持人模板：

1
moderator_list: 1
2
moderator_list[0]: 76561199259665520

配置好后按快捷键 Ctrl+S 保存退出

运行欧卡专用服务器#

Terminal window

1
cd ~/Steam/ets2_server/bin/linux_x64/ && ./server_launch.sh

启动后，在启动日志中找到 [MP] Session search id: 855683929xxxxxxxxxx/101，在游戏内「联运」列表搜索即可看到你的服务器房间。

常见问题#

564 错误：已知 bug，无视即可。

ets-map-example 欧卡在线地图示例

Thu, 03 Sep 2026 00:00:00 GMT

🗺️ 项目介绍#

ets-map-example 是一个 ETS2（欧洲卡车模拟 2）地图代码示例项目，包含标准地图和 ProMods 地图两套数据，并支持双颜色主题切换。适合想要在网页中嵌入欧卡地图、展示位置坐标或进行二次开发的开发者参考。

⭐ 开源地址：https://github.com/opwop1/ets-map-example

🖥️ 在线演示：https://opwop1.github.io/ets-map-example

✨ 功能特性#

标准地图：基于 ETS2 原版游戏地图数据
ProMods 地图：支持 ProMods 模组地图数据展示
双颜色主题：支持两套配色方案切换，适配不同视觉偏好
在线演示：通过 GitHub Pages 提供可直接访问的在线地图

💡 适用场景#

车队 / 社区网站嵌入欧卡地图展示活动路线
基于坐标开发位置查询、路线规划等工具
学习地图瓦片加载与前端地图渲染的实现方式
与 TruckersMP 玩家实时位置数据结合，做位置可视化

🚀 快速开始#

Terminal window

1
# 克隆项目
2
git clone https://github.com/opwop1/ets-map-example.git
3
cd ets-map-example
4

5
# 安装依赖并启动
6
npm install
7
npm run dev

也可以直接访问在线演示快速预览效果，标准地图与 ProMods 地图均可切换查看。

koishi-plugin-adapter-mail-pro 邮件适配器

Thu, 03 Sep 2026 00:00:00 GMT

📬 项目介绍#

koishi-plugin-adapter-mail-pro 是一款基于 @satorijs/adapter-mail 扩展开发的 Koishi 邮件适配器插件。它让 Koishi 机器人可以直接通过 SMTP 发送邮件、IMAP 接收邮件，把邮件变成机器人的一种”聊天平台”——收到的邮件会触发消息事件，发送邮件就像发私聊消息一样简单。

opwop1

koishi-plugin-adapter-mail-pro

邮件适配器增强版，支持自定义邮件主题、发件人名称、STARTTLS加密模式

—

no-license

JavaScript

⭐ 开源地址：https://github.com/opwop1/koishi-plugin-adapter-mail-pro

✨ 功能特性#

SMTP 发送：通过标准 SMTP 协议发送邮件，支持 SSL 直连与 STARTTLS
IMAP 接收：实时监听新邮件并触发 Koishi 消息事件
私聊语义：邮件被当作私聊消息处理，发件人邮箱即 userId
自定义标题：单封邮件可覆盖默认主题（subject）
自定义发件人：单封邮件可覆盖默认发件人名称（fromName）
广泛兼容：QQ 邮箱、163、Gmail、Outlook、企业邮箱等标准 SMTP/IMAP 服务均可使用

📦 安装与配置#

1. 准备邮箱信息#

在邮箱后台获取以下信息：

SMTP 服务器地址和端口（用于发送）
IMAP 服务器地址和端口（用于接收）
授权码 / 应用专用密码（大部分邮箱不允许直接使用登录密码）

2. 配置示例#

1
{
2
  "username": "your@email.com",
3
  "password": "your_authorization_code",
4
  "selfId": "your@email.com",
5
  "subject": "Koishi",
6
  "imap": {
7
    "host": "imap.example.com",
8
    "port": 993,
9
    "tls": true
10
  },
11
  "smtp": {
12
    "host": "smtp.example.com",
13
    "port": 465,
14
    "tls": true
15
  }
16
}

展开收起

配置项	必填	说明
`username`	是	邮箱账号
`password`	是	密码或授权码
`selfId`	否	邮件地址（默认同 username）
`name`	否	发件人显示名称
`subject`	否	机器人发送邮件的默认主题
`imap`	-	接收服务器配置（host / port / tls）
`smtp`	-	发送服务器配置（host / port / tls）

🚀 使用方法#

发送邮件#

给邮件适配器”发私聊消息”即可发送邮件，频道格式固定为 private:对方邮箱地址：

1
const bot = ctx.bots.find((b) => b.platform === "mail");
2
await bot.sendMessage("private:someone@example.com", "你好，这是一封测试邮件");

也可以封装成指令：

1
ctx
2
  .command("sendmail <to> <content:text>")
3
  .action(async ({ session }, to, content) => {
4
    const bot = ctx.bots.find((b) => b.platform === "mail");
5
    if (!bot) return "mail 适配器未启用";
6
    await bot.sendMessage(`private:${to}`, content);
7
    return "已发送";
8
  });

自定义邮件标题与发件人#

1
import { h } from "koishi";
2

3
const bot = ctx.bots.find((b) => b.platform === "mail");
4
await bot.sendMessage(
5
  "private:someone@example.com",
6
  h("message", { subject: "这里是标题", fromName: "这里是发件人名字" }, "这里是正文内容"),
7
);

接收邮件#

开启 IMAP 后，新邮件会触发 Koishi 消息事件（私聊消息），发件人邮箱就是 session.userId：

1
ctx.on("message", async (session) => {
2
  if (session.platform !== "mail") return;
3
  // session.userId 就是发件人邮箱
4
  await session.send(`已收到你的邮件：${session.content}`);
5
});

🌐 常见邮箱服务参数#

Outlook / Microsoft 365 / Exchange Online#

协议	服务器	端口	TLS
SMTP（STARTTLS，微软官方推荐）	`smtp.office365.com`	587	`true`
SMTP（SSL 直连）	`smtp.office365.com`	465	`true`
IMAP	`outlook.office365.com`	993	`true`

端口为 587 且 smtp.tls 为 true 时会自动走 STARTTLS。若开启了双重验证，需要生成”应用专用密码”。

QQ 邮箱 / 163 等#

请在邮箱后台开启 SMTP/IMAP 服务并生成授权码，服务器地址与端口以官方文档为准。

❓ 常见问题#

一直发不出去：检查 SMTP 配置是否正确，端口是否匹配 TLS
收不到邮件：检查 IMAP 是否开启，端口和 TLS 是否正确
需要授权码：大部分邮箱不允许直接用登录密码，需在邮箱后台生成”授权码”

📄 许可证#

MIT License

koishi-plugin-auto-exit-group 自动退群管家

Thu, 03 Sep 2026 00:00:00 GMT

🤖 项目介绍#

koishi-plugin-auto-exit-group 是一款 Koishi 群组管理插件（仅限 OneBot 平台），基于白名单机制帮助机器人自动清理群组：定时检查机器人所在的群列表，自动退出未加入白名单的群。对于被频繁拉群、群数量失控的机器人来说，这是一个非常实用的”瘦身”工具。

opwop1

koishi-plugin-auto-exit-group

自动退出未设置群号的群（仅限onebot平台）

—

no-license

JavaScript

⭐ 开源地址：https://github.com/opwop1/koishi-plugin-auto-exit-group

✨ 功能特性#

定时自动检查：按配置间隔自动检查机器人所在群列表并退出未白名单群
白名单机制：只保留配置中列出的群，其余全部退出
多实例支持：支持多个 OneBot 适配器实例同时使用
启动即检查：机器人启动时立即执行一次检查
手动指令：提供手动触发检查与查看白名单的命令

⚙️ 配置项#

配置项	类型	默认值	说明
`allowedGroups`	`string[]`	`[]`	允许保留的群号列表（白名单）
`interval`	`number`	`60`	检查间隔时间（分钟），最小值为 1
`enabled`	`boolean`	`true`	是否启用自动退群功能

示例配置#

1
plugins:
2
  auto-exit-group:
3
    allowedGroups:
4
      - "123456789"
5
      - "987654321"
6
    interval: 30
7
    enabled: true

📋 指令说明#

命令	说明
`auto-exit/check`	手动触发检查并退出不在白名单的群
`auto-exit/whitelist`	查看当前白名单群列表

📝 使用步骤#

配置白名单：在 Koishi 控制台的插件配置中，将需要保留的群号添加到 allowedGroups
启用插件：确保 enabled 配置项为 true
设置间隔：根据需要设置 interval，默认 60 分钟检查一次

⚠️ 注意事项#

仅支持 OneBot 平台：本插件仅适用于 OneBot（如 go-cqhttp、NapCat 等）适配器
谨慎配置白名单：如果白名单为空，机器人将退出所有群！请在启用前确认白名单配置正确
权限要求：机器人需要有退出群聊的权限
日志查看：可通过 Koishi 控制台日志了解退群情况

📄 许可证#

MIT License

koishi-plugin-ets2-tools-tmp 欧卡tmp信息查询插件

Thu, 03 Sep 2026 00:00:00 GMT

🚛 项目介绍#

koishi-plugin-ets2-tools-tmp 是一款专为欧洲卡车模拟 2（ETS2）/ 美国卡车模拟（ATS）玩家打造的多功能 Koishi 插件，集成 TruckersMP 数据查询与车队活动管理功能。支持自动获取活动信息、智能提醒推送，提供丰富的游戏数据查询服务，完美适配 QQ 等主流聊天平台。

opwop1

koishi-plugin-ets2-tools-tmp

⭐ 开源地址：https://github.com/opwop1/koishi-plugin-ets2-tools-tmp

✨ 功能特性#

🎮 核心查询功能#

玩家数据查询：支持 TMP 玩家信息、实时位置查询，绑定 ID 后操作更便捷
服务器与路况：查询欧卡 / 美卡服务器状态、热门地点路况（支持服务器简称速查）
游戏资源查询：地图 DLC 价格、TMP 版本信息一键获取
排行与积分：总里程 / 今日里程排行榜、车队平台积分查询
VTC 与规则：支持指定 VTC ID 查询，提供 TruckersMP 官方规则快速链接
TMP 版本更新通知：TMP 发布新版本时自动通知

🚚 车队活动管理#

双数据源支持：同时对接车队平台和 TruckersMP API 获取活动数据
智能提醒机制：活动开始前按配置时间自动发送提醒，支持多时间点精准设置
档位状态检查：自动检测活动档上传状态，及时向管理群发送提醒
多群组适配：区分管理群与主群，按需发送不同类型通知消息

⚙️ 灵活配置选项#

数据源自定义：独立选择服务器、起点、终点信息来源（车队平台 / TMP API）
定时任务配置：自定义活动检查、消息发送的时间节点
消息模板编辑：支持变量替换的个性化提醒模板，打造专属通知风格
权限与适配：管理员专用功能（密码重置），兼容主流聊天平台

📋 指令速览#

指令	说明	示例
绑定	绑定 TMP ID，后续指令可省略 ID	`绑定 123`
查询	查询 TMP 玩家基础信息	`查询 123`
定位	查询玩家当前位置	`定位 123`
路况	查询热门地点路况，支持简称 s1 / s2 / p / a	`路况 s1`
欧卡服务器 / 美卡服务器	查询服务器状态列表	`欧卡服务器`
tmp版本	查询 TMP 当前版本信息	`tmp版本`
地图dlc价格	查看地图 DLC 价格列表	`地图dlc价格`
里程排行榜	总里程排行榜（绑定后可查个人排名）	`里程排行榜`
今日里程排行榜	每日 0 点重置的日榜	`今日里程排行榜`
vtc查询	查询指定 VTC ID 详情	`vtc查询 456`
查询积分	查询车队平台积分	`查询积分 123456`
规则查询	获取 TruckersMP 官方规则链接	`规则查询`
活动查询	手动检查今日活动数据	`活动查询`
今日/昨日足迹	查看足迹记录（含 p 服单独指令）	`今日足迹 123`

📦 安装与配置#

1. 基础 API 配置#

车队平台 URL：自行部署的车队平台地址（不含协议）
车队平台 TOKEN：API 访问认证令牌
VTC ID：您在 TruckersMP 的 VTC ID

2. 群组配置#

管理群：接收档位状态、异常通知等管理提醒
主群：接收活动开始提醒，支持自定义提醒模板与提醒时间点

3. 提醒模板变量#

活动提醒消息模板支持以下变量替换：

变量	含义
`{name}`	活动名
`{server}`	服务器
`{startingPoint}`	起点
`{terminalPoint}`	终点
`{distance}`	距离
`{banner}`	横幅
`{timeLeft}`	剩余时间

🔍 技术栈与依赖#

支持平台：Koishi（兼容主流聊天平台，除邮件适配器外）
核心依赖：HTTP 请求、定时任务、数据库
车队平台支持：V1.0、V2.0
接口文档：TMP 数据接口文档

📝 使用提示#

路况查询需按规则输入服务器简称（s1 / s2 / p / a）
管理员专用功能（如重置密码）需提前配置管理员权限
定时任务未执行时，可检查服务器时间与配置时间是否匹配
启用调试模式可输出详细运行日志，便于排查问题

致谢#

特别感谢 79887143 提供的 API 接口与开发思路，本项目基于其开源项目 koishi-plugin-tmp-bot 扩展开发。

koishi-plugin-platform-clock 车队平台打卡排行榜插件

Thu, 03 Sep 2026 00:00:00 GMT

🕐 项目介绍#

koishi-plugin-platform-clock 是一款车队平台打卡统计 Koishi 插件。插件调用车队平台接口，按活动开始日期统计成员打卡次数，生成前 10 名打卡排行榜图片，并支持定时推送到群聊。排行榜以精美的 PNG 图片发送，前三名拥有金银铜特殊徽章，让打卡激励一目了然。

opwop1

koishi-plugin-platform-clock

车队平台1.0积分统计插件，支持按日期查询积分排行榜，并以精美图片形式展示。同时支持每周/每月定时推送排名。

—

no-license

TypeScript

⭐ 开源地址：https://github.com/opwop1/koishi-plugin-platform-clock

✨ 功能特性#

按日期范围统计：基于打卡记录的 activityStartTime 字段精确统计
精美排行榜图片：以 PNG 图片形式发送，视觉呈现更直观
前三名徽章：金银铜特殊徽章彰显荣誉
车队编号匹配：根据用户 ID 自动匹配并展示车队编号
定时推送：每周日 22<00> 推送周榜，每月最后一天 22<00> 推送月榜
权限控制：仅允许 OneBot 适配器使用指令，支持限制指令可用群聊与推送群聊
自动分页：接口数据自动按 totalPage 请求全部分页

📦 前置依赖#

依赖	说明
koishi-plugin-puppeteer	用于将排行榜 HTML 渲染为图片
OneBot 适配器	用于执行查询指令和发送定时排行

⚙️ 配置项#

配置项	类型	必填	说明
`platformUrl`	`string`	是	车队平台地址，例如 `https://example.com`
`token`	`string`	是	车队平台 API Token
`allowedGroups`	`string[]`	否	允许使用查询指令的群聊 ID 列表
`sendGroups`	`string[]`	否	定时推送排行榜的群聊 ID 列表

token 仅用于请求用户信息接口；打卡记录接口按当前平台接口格式请求，两个接口都会自动分页拉取全量数据。

📋 指令说明#

打卡排行#

别名：clock-rank

查询指定日期范围内的打卡排行榜，日期筛选使用打卡记录的 activityStartTime 字段，统计同一 userId 在范围内的记录数量。

格式：

1
打卡排行 <开始日期> <结束日期>

示例：

1
打卡排行 2026-07-01 2026-07-22
2
clock-rank 2026-07-01 2026-07-22

使用限制：

仅限 OneBot 适配器
仅限 allowedGroups 中配置的群聊使用
日期格式必须为 YYYY-MM-DD
开始日期不能晚于结束日期

⏰ 定时推送#

任务	时间	统计范围
周排行	每周日 22<00>	本周周一至周日
月排行	每月最后一天 22<00>	当月 1 日至月末

推送目标为 sendGroups 中配置的群聊，插件只会向 OneBot 机器人发送消息。

🖼️ 排行榜图片内容#

排名、成员名称和打卡次数
前三名金银铜特殊徽章
匹配成功时显示车队编号
统计日期范围和参与人数

📄 许可证#

MIT License