Admin: Новая страница: «= Настройка API и веб-хуков для Bedrock сервера = == 1. Подготовка == * Убедитесь, что Bedrock сервер у…»

2025-11-03T10:17:38Z

Новая страница: «= Настройка API и веб-хуков для Bedrock сервера = == 1. Подготовка == * Убедитесь, что Bedrock сервер у…»

Новая страница

= Настройка API и веб-хуков для Bedrock сервера =

== 1. Подготовка ==

* Убедитесь, что Bedrock сервер установлен и работает.
* Установите Node.js или Python для создания API.
* Имейте базовые знания веб-разработки.
* Рекомендуется использовать Ubuntu 24.04 LTS.

== 2. Создание REST API ==

=== Установка Node.js ===

1. Установите Node.js:
<pre>curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs</pre>

2. Проверьте установку:
<pre>node -v
npm -v</pre>

=== Создание проекта ===

1. Создайте директорию:
<pre>sudo mkdir -p /opt/bedrock-api
cd /opt/bedrock-api</pre>

2. Инициализируйте проект:
<pre>sudo npm init -y</pre>

3. Установите зависимости:
<pre>sudo npm install express body-parser cors axios</pre>

=== Базовый API сервер ===

1. Создайте файл app.js:
<pre>sudo nano app.js</pre>

2. Добавьте содержимое:
<pre>const express = require('express');
const { spawn } = require('child_process');
const bodyParser = require('body-parser');
const cors = require('cors');
const app = express();
const port = 3000;

app.use(cors());
app.use(bodyParser.json());

\# Функция выполнения команд
function executeCommand(command) {
return new Promise((resolve, reject) => {
const proc = spawn('sudo', ['systemctl', ...command.split(' ')]);
let output = '';
let error = '';

proc.stdout.on('data', (data) => {
output += data.toString();
});

proc.stderr.on('data', (data) => {
error += data.toString();
});

proc.on('close', (code) => {
if (code === 0) {
resolve(output);
} else {
reject(error || `Command failed with code ${code}`);
}
});
});
}

\# Функция отправки команды в консоль сервера
function sendServerCommand(command) {
return new Promise((resolve) => {
const proc = spawn('screen', ['-S', 'minecraft-bedrock', '-X', 'stuff', command + '\\n']);
proc.on('close', () => {
setTimeout(resolve, 1000);
});
});
}

\# API Endpoints

\# Статус сервера
app.get('/api/server/status', async (req, res) => {
try {
const result = await executeCommand('systemctl is-active minecraft-bedrock');
const status = result.trim() === 'active' ? 'running' : 'stopped';
res.json({ status });
} catch (error) {
res.json({ status: 'stopped', error: error.message });
}
});

\# Запуск сервера
app.post('/api/server/start', async (req, res) => {
try {
await executeCommand('systemctl start minecraft-bedrock');
res.json({ success: true, message: 'Server started' });
} catch (error) {
res.status(500).json({ success: false, error: error.message });
}
});

\# Остановка сервера
app.post('/api/server/stop', async (req, res) => {
try {
await executeCommand('systemctl stop minecraft-bedrock');
res.json({ success: true, message: 'Server stopped' });
} catch (error) {
res.status(500).json({ success: false, error: error.message });
}
});

\# Перезапуск сервера
app.post('/api/server/restart', async (req, res) => {
try {
await executeCommand('systemctl restart minecraft-bedrock');
res.json({ success: true, message: 'Server restarted' });
} catch (error) {
res.status(500).json({ success: false, error: error.message });
}
});

\# Выполнение команды
app.post('/api/server/command', async (req, res) => {
const { command } = req.body;

if (!command) {
return res.status(400).json({ error: 'Command is required' });
}

try {
await sendServerCommand(command);
res.json({ success: true, message: 'Command sent' });
} catch (error) {
res.status(500).json({ success: false, error: error.message });
}
});

\# Получение логов
app.get('/api/server/logs', (req, res) => {
const fs = require('fs');
const logFile = '/opt/bedrock/logs/latest.log';
const lines = parseInt(req.query.lines) || 100;

try {
const content = fs.readFileSync(logFile, 'utf-8');
const logLines = content.split('\\n').slice(-lines);
res.json({ logs: logLines });
} catch (error) {
res.status(500).json({ error: error.message });
}
});

\# Информация о сервере
app.get('/api/server/info', async (req, res) => {
const fs = require('fs');

try {
const pid = require('child_process').execSync('pgrep bedrock_server').toString().trim();
const memory = parseInt(require('child_process').execSync(`ps -o rss= -p ${pid}`).toString().trim()) / 1024;
const cpu = require('child_process').execSync(`ps -o %cpu= -p ${pid}`).toString().trim();

const props = {};
const propsContent = fs.readFileSync('/opt/bedrock/server.properties', 'utf-8');
propsContent.split('\\n').forEach(line => {
if (line && !line.startsWith('#')) {
const [key, value] = line.split('=');
if (key && value) {
props[key.trim()] = value.trim();
}
}
});

res.json({
pid,
memory: memory.toFixed(2),
cpu,
properties: props
});
} catch (error) {
res.status(500).json({ error: error.message });
}
});

app.listen(port, () => {
console.log(`Bedrock API server running on port ${port}`);
});</pre>

3. Запустите API:
<pre>sudo node app.js</pre>

== 3. Настройка systemd сервиса ===

=== Создание сервиса ===

1. Создайте файл сервиса:
<pre>sudo nano /etc/systemd/system/bedrock-api.service</pre>

2. Добавьте конфигурацию:
<pre>[Unit]
Description=Bedrock Server API
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/bedrock-api
ExecStart=/usr/bin/node app.js
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target</pre>

3. Запустите сервис:
<pre>sudo systemctl daemon-reload
sudo systemctl enable bedrock-api
sudo systemctl start bedrock-api
sudo systemctl status bedrock-api</pre>

== 4. Настройка веб-хуков ===

=== Создание webhook endpoint ===

1. Добавьте в app.js:
<pre>const axios = require('axios');

\# Webhook конфигурация
const webhookConfig = {
url: process.env.WEBHOOK_URL || 'https://discord.com/api/webhooks/YOUR_WEBHOOK',
enabled: true
};

function sendWebhook(event, data) {
if (!webhookConfig.enabled) return;

const payload = {
content: `🚨 **${event}**\\n\\n${JSON.stringify(data, null, 2)}`
};

axios.post(webhookConfig.url, payload).catch(err => {
console.error('Webhook error:', err.message);
});
}

\# Webhook endpoint для событий
app.post('/api/webhook/event', (req, res) => {
const { event, data } = req.body;

sendWebhook(event, data);
res.json({ success: true });
});

\# Автоматические webhook события
app.post('/api/server/start', async (req, res) => {
try {
await executeCommand('systemctl start minecraft-bedrock');
sendWebhook('Server Started', { timestamp: new Date() });
res.json({ success: true, message: 'Server started' });
} catch (error) {
res.status(500).json({ success: false, error: error.message });
}
});</pre>

== 5. Аутентификация API ===

=== Добавление токенов ===

1. Обновите app.js:
<pre>const API_TOKEN = process.env.API_TOKEN || 'your-secret-token';

\# Middleware для проверки токена
function authenticate(req, res, next) {
const token = req.headers['authorization']?.replace('Bearer ', '') || req.query.token;

if (token === API_TOKEN) {
next();
} else {
res.status(401).json({ error: 'Unauthorized' });
}
}

\# Применение к защищенным routes
app.post('/api/server/*', authenticate);
app.get('/api/server/logs', authenticate);</pre>

2. Использование:
<pre>curl -H "Authorization: Bearer your-secret-token" http://localhost:3000/api/server/status</pre>

== 6. Примеры использования ===

=== Получение статуса ===

<pre>curl http://localhost:3000/api/server/status</pre>

Ответ:
<pre>{
"status": "running"
}</pre>

=== Выполнение команды ===

<pre>curl -X POST http://localhost:3000/api/server/command \\
-H "Content-Type: application/json" \\
-H "Authorization: Bearer your-secret-token" \\
-d '{"command": "say Hello from API"}'</pre>

=== Получение логов ===

<pre>curl "http://localhost:3000/api/server/logs?lines=50"</pre>

== 7. Настройка Nginx для API ===

=== Проксирование ===

1. Создайте конфигурацию Nginx:
<pre>sudo nano /etc/nginx/sites-available/bedrock-api</pre>

2. Добавьте конфигурацию:
<pre>server {
listen 80;
server_name api.yourdomain.com;

location / {
proxy_pass http://localhost:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
}
}</pre>

3. Активируйте сайт:
<pre>sudo ln -s /etc/nginx/sites-available/bedrock-api /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx</pre>

== 8. Мониторинг через API ===

=== Создание клиента ===

1. Пример JavaScript клиента:
<pre>const axios = require('axios');

const apiClient = axios.create({
baseURL: 'http://localhost:3000/api',
headers: {
'Authorization': 'Bearer your-secret-token'
}
});

async function checkServerStatus() {
try {
const response = await apiClient.get('/server/status');
console.log('Server status:', response.data.status);
} catch (error) {
console.error('Error:', error.message);
}
}

setInterval(checkServerStatus, 60000);</pre>

== 9. Безопасность ===

=== Рекомендации ===

1. Используйте HTTPS для внешнего доступа
2. Ограничьте доступ по IP
3. Используйте сильные токены
4. Регулярно обновляйте зависимости

== 10. Устранение неполадок ===

=== Проблемы с API ===

1. Проверьте логи: <pre>sudo journalctl -u bedrock-api -f</pre>
2. Проверьте порт: <pre>sudo netstat -tlnp | grep 3000</pre>
3. Проверьте права sudo

== Заключение ==

Настройка API и веб-хуков для Bedrock сервера позволяет интегрировать сервер с внешними системами и автоматизировать управление. REST API предоставляет удобный интерфейс для управления сервером программно.

'''Для размещения ваших Bedrock серверов с API на надежном хостинге рекомендуем воспользоваться услугами [ARK-HOSTER.RU](https://ark-hoster.ru):'''

* '''[Выделенные серверы](https://ark-hoster.ru/dedicated/)''' - для высоконагруженных Bedrock серверов
* '''[VPS/VDS серверы](https://ark-hoster.ru/vpsgame/)''' - для небольших и средних серверов

Наши специалисты помогут с настройкой API и веб-хуков для Bedrock серверов!

Настройка API и веб-хуков для Bedrock сервера - История изменений

Admin: Новая страница: «= Настройка API и веб-хуков для Bedrock сервера = == 1. Подготовка == * Убедитесь, что Bedrock сервер у…»