Восставший из ада.

Пользователь GitHub под ником mk6i (Mike) с июня 2023 года активно работает над сервером для мессенджеров, работающих по протоколу OSCAR.

Дисклеймер от автора. Этот проект является независимой инициативой с открытым исходным кодом и не связан, не одобрен и не ассоциирован с AOL или Yahoo! Inc. Этот проект полностью некоммерческий, он не приносит дохода и не принимает пожертвований.

Поддерживаются следующие функции:

На данный момент для загрузки доступна версия 0.22.0 для Windows, MacOS и Linux.

Подключитесь к Open OSCAR Server и начните работу с помощью одного из этих удобных руководств по быстрому запуску сервера.

В этом руководстве объясняется, как загрузить, настроить и запустить сервер Open OSCAR в Linux (x86_64).

Скачайте последнюю версию Linux с страницы релизов и распакуйте архив. В распакованной папке находятся приложение и файл конфигурации settings.env.

Установите listener (слушатель) по умолчанию в SCAR_ADVERTISED_LISTENERS_ PLAIN в settings.env к имени хоста и порту, к которым могут подключаться клиенты AIM. Если клиент и сервер AIM работают на одном компьютере, менять значение по умолчанию не нужно.

Формат [NAME]://[HOSTNAME]:[PORT], где:

Чтобы подключить клиентов AIM к локальной сети (включая виртуальные машины с мостовой сетью), можно найти соответствующий IP-адрес, выполнив команду ifconfig в терминале, и использовать его вместо 127.0.0.1.

Чтобы запустить сервер Open OSCAR, выполните следующую команду:

./open_oscar_server

Сервер Open OSCAR будет запущен в терминале и готов принимать клиентские подключения AIM.

Для быстрой проверки запустите клиент AIM, войдите на сервер и отправьте себе мгновенное сообщение. Настройте клиент AIM на подключение к хосту и порту из OSCAR_ADVERTISED_LISTENERS_PLAIN в файле settings.env. Если вы используете настройки сервера по умолчанию, укажите в качестве хоста 127.0.0.1, а в качестве порта - 5190.

Более подробную информацию о настройке клиента AIM смотри в Руководстве по настройке клиента.

По умолчанию при входе в AIM можно ввести любое имя пользователя и пароль для автоматического создания учетной записи.

Автоматическое создание учетной записи - это удобная функция для локальной разработки. При развертывании в рабочей среде следует установить DISABLE_AUTH=false в файле settings.env, чтобы обеспечить аутентификацию учетной записи. Учетные записи пользователей можно создавать с помощью менеджмента API.

Дополнительные шаги по настройке, которые повысят удобство использования Open OSCAR Server, описаны в руководстве по дополнительной настройке.

Загрузите последнюю версию macOS со страницы релизов для вашей платформы (Intel или Apple Silicon).

Поскольку бинарный файл Open OSCAR Server не одобрен Apple, браузеры, такие как Chrome, могут посчитать его «подозрительным» и заблокировать загрузку. В этом случае вам нужно будет явно разрешить загрузку ненадежного файла.

Несмотря на то, что бинарные файлы на 100 % безопасны, вы можете избежать проблем с безопасностью, собрав приложение самостоятельно. (Автор не предоставляет подписанные бинарные файлы из-за их высокой стоимости и сложности)

После загрузки распакуйте ZIP-архив, в котором находится приложение и файл конфигурации settings.env.

Откройте терминал и перейдите в каталог, куда распаковали приложение. Этот терминал будет использоваться для выполнения оставшихся действий.

cd ~/Downloads/open_oscar_server.0.21.0.macos.intel_x86_64/

macOS помещает двоичный файл Open OSCAR Server в карантин, поскольку он не одобрен Apple. Чтобы снять карантин, выполните в том же терминале следующую команду:

sudo xattr -d com.apple.quarantine ./open_oscar_server

В файле settings.env укажите в OSCAR_ADVERTISED_LISTENERS_PLAIN имя хоста и порт, к которым могут подключаться клиенты AIM. Если клиент и сервер AIM работают на одном компьютере, менять значение по умолчанию не нужно.

Формат [NAME]://[HOSTNAME]:[PORT], где:

Чтобы подключить клиентов AIM к локальной сети (включая виртуальные машины с мостовой сетью), можно найти соответствующий IP-адрес, выполнив команду ifconfig в терминале, и использовать его вместо 127.0.0.1.

osascript -e "IPv4 address of (system info)"

Чтобы запустить сервер Open OSCAR, выполните следующую команду:

./open_oscar_server

Сервер Open OSCAR будет запущен в терминале и готов принимать клиентские подключения AIM.

Для быстрой проверки запустите клиент AIM, войдите на сервер и отправьте себе мгновенное сообщение. Настройте клиент AIM на подключение к хосту и порту из OSCAR_ADVERTISED_LISTENERS_PLAIN в файле settings.env. Если вы используете настройки сервера по умолчанию, укажите в качестве хоста 127.0.0.1, а в качестве порта — 5190.

Более подробную информацию о настройке клиента AIM см. в Руководстве по настройке клиента.

По умолчанию при входе в AIM можно ввести любое имя пользователя и пароль для автоматического создания учетной записи.

Автоматическое создание учетной записи - это удобная функция для локальной разработки. При развертывании в рабочей среде следует установить DISABLE_AUTH=false в файле settings.env, чтобы обеспечить аутентификацию учетной записи. Учетные записи пользователей можно создавать с помощью менеджмента API.

Дополнительные шаги по настройке, которые повысят удобство использования Open OSCAR Server, описаны в руководстве по дополнительной настройке.

В этом руководстве объясняется, как загрузить, настроить и запустить Open OSCAR Server на Windows 10/11.

Загрузите последнюю версию для Windows со страницы релизов и распакуйте .zip архив, содержащий приложение и файл конфигурации settings.env.

Откройте settings.env(щелкните правой кнопкой мыши edit in notepad) и установите в качестве имени хоста и порта по умолчанию имя listener (слушателя) OSCAR_ADVERTISED_LISTENERS_PLAIN, к которому смогут подключаться клиенты AIM. Если клиент и сервер AIM работают на одной машине, изменять значение по умолчанию не нужно.

Формат [NAME]://[HOSTNAME]:[PORT], где:

Для подключения клиентов AIM к вашей локальной сети (включая виртуальные машины с мостовым сетевым подключением) вы можете найти соответствующий IP-адрес, запустив команду ipconfigв командной строке, и использовать этот IP-адрес вместо 127.0.0.1.

Запустите open_oscar_server.exe, чтобы открыть OSCAR Server.

Поскольку Open OSCAR Server не заслужил достаточной репутации у Microsoft, Windows пометит это приложение как представляющее угрозу безопасности при первом запуске. Вам будет показано Microsoft Defender SmartScreen предупреждение с возможностью запуска заблокированного приложения.

Для продолжения нажмите More Options (Дополнительные параметры), затем Run anyway (Запустить в любом случае).

Нажмите Allow (Разрешить), если появится предупреждение брандмауэра Windows Defender.

Open OSCAR Server откроется в терминале и будет готов принимать подключения от AIM-клиентов.

Для быстрой проверки запустите клиент AIM, войдите на сервер и отправьте себе мгновенное сообщение. Настройте клиент AIM на подключение к хосту и порту из OSCAR_ADVERTISED_LISTENERS_PLAIN в файле settings.env. Если вы используете настройки сервера по умолчанию, укажите в качестве хоста 127.0.0.1, а в качестве порта - 5190.

Более подробную информацию о настройке клиента AIM см. в Руководстве по настройке клиента.

По умолчанию при входе в AIM можно ввести любое имя пользователя и пароль для автоматического создания учетной записи.
Автоматическое создание учетной записи - это удобная функция для локальной разработки. При развертывании в рабочей среде следует установить DISABLE_AUTH=false в файле settings.env, чтобы обеспечить аутентификацию учетной записи. Учетные записи пользователей можно создавать с помощью менеджмента API.

Дополнительные шаги по настройке, которые повысят удобство использования Open OSCAR Server, описаны в руководстве по дополнительной настройке.

У вас еще не установлен AIM? Ознакомьтесь с руководством по настройке клиента AIM.

В этом руководстве объясняется, как установить и настроить клиенты Windows AIM 5.x для Open OSCAR Server.

Если вы хотите насладиться последней версией AIM с «классическим» ощущением начала 2000-х, рекомендуется использовать AIM 5.x.

Версии Windows AIM 5.0-5.1.3036 отлично работают в Wine . Вот как настроить AIM 5.1.3036.

wine aim513036.exe

Так как автор проекта удалил или скрыл репозиторий клиента для MacOS, можно установить Winehq и далее следовать шагам 2 и 3 из руководства для Linux / FreeBSD.

Еще можно скачать клиент AIM для MacOS отсюда, отсюда или отсюда.

После установки настройте AIM для подключения к серверу Open OSCAR.

1. На экране входа в систему нажмите Setup.

2. В разделе Sign On/Off нажмите Connection.

3. Настройте поля хоста и порта сервера в соответствии с настройками, OSCAR_ADVERTISED_LISTENERS_PLAINуказанными в файле конфигурации config/settings.env. Например, если OSCAR_ADVERTISED_LISTENERS_PLAIN=LOCAL://127.0.0.1:5190, установите значение Hostна 127.0.0.1, а Portзначение на 5190.

4. Нажмите ОК и войдите в AIM!

...а как насчет ICQ? Ознакомьтесь с руководством по настройке клиента ICQ .

В этом руководстве объясняется, как установить и настроить ICQ 2000b для Open OSCAR Server.

ICQ 2000b — единственная версия ICQ, которая в настоящее время поддерживается RAS.

После завершения установки перед вами откроется окно регистрации ICQ. Не завершайте мастер регистрации. Закройте окно и перейдите к шагам пункта Настройка после установки.

ICQ 2000b можно запустить под Linux через WINE.

После завершения установки перед вами откроется окно регистрации ICQ. Не завершайте мастер регистрации. Закройте окно и перейдите к шагам пункта Настройка после установки.

1. Установите WineskinServer через Homebrew:

brew install --cask --no-quarantine gcenx/wine/wineskin

2. Создайте пустую оболочку приложения.

Запустите программу Wineskin Winery. Установите последнюю версию движка и создайте новый пустой контейнер для установки ICQ.

Создание оболочки может занять 1-2 минуты, и в это время приложение может не отвечать. После завершения нажмите кнопку View wrapper в Finder.

3. Установите ICQ в оболочку приложения. Запустите оболочку из окна Finder. Выберите Install Software.

Выберите Choose Setup Executableи откройте исполняемый файл установщика ICQ.

4. Завершите работу мастера установки ICQ.

5. Закройте окно регистрации

После завершения установки перед вами откроется окно регистрации ICQ. Не завершайте мастер регистрации. Закройте окно и перейдите к шагам пункта Настройка после установки.

На этом шаге мы заменим стандартное имя хоста сервера ICQ на имя хоста вашего сервера Open OSCAR в реестре Windows.

Не пытайтесь установить имя хоста ICQ через окно регистрации. В противном случае возникнет ошибка, которая не позволит клиенту "запоминать" такие настройки, как сохраненные пароли и имя хоста OSCAR.

1. Откройте редактор реестра

Windows

Wine (Linux)

WineskinServer (macOS)

~/Applications/Wineskin/icq2000b.app/Contents/Wineskin.app/Contents/Resources/regedit

2. Откройте настройки ICQ по умолчанию

Перейдите по ссылке HKEY_CURRENT_USER\Software\Mirabilis\ICQ\DefaultPrefs.

3. Настройте хост OSCAR

4. Настройка порта сервера (редкий параметр)

Изменяйте это значение только в том случае, если ваш сервер не прослушивает порты OSCAR по умолчанию.

5. Настройка клиента завершена. Закройте редактор реестра.

Запустите ICQ и пройдите мастер первоначальной регистрации. Для начала выберите Existing User.

Не пытайтесь создать нового пользователя в мастере регистрации. Чтобы создать нового пользователя в Open OSCAR Server, следуйте инструкциям по созданию учетной записи, приведенным в руководствах по быстрому запуску сервера .

Введите учетные данные пользователя ICQ. Если вы используете RAS с настройками по умолчанию, вы можете ввести любой UIN и пароль. Нажимайте кнопку «Далее» на оставшихся экранах, пока мастер не завершит работу.

Теперь вы сможете подключиться к серверу Open OSCAR с помощью ICQ 2000b.

Автор проекта не тестировал клиенты для android, ios и j2me. Возможно некоторые версии клиентов, после модификации смогут подключится к серверу Open OSCAR.

Менеджмент API предоставляет функциональность для администрирования сервера (см. спецификацию OpenAPI ). Ниже показано, как выполнять эти команды через командную строку.

Выполните эти команды из PowerShell , а не из командной строки .

Invoke-WebRequest -Uri http://localhost:8080/user -Method Get

Invoke-WebRequest -Uri http://localhost:8080/user `
-Body '{"screen_name":"MyScreenName", "password":"thepassword"}' `
-Method Post `
-ContentType "application/json"

Invoke-WebRequest -Uri http://localhost:8080/user `
-Body '{"screen_name": "user123"}' `
-Method Delete `
-ContentType "application/json"

Invoke-WebRequest -Uri http://localhost:8080/user/password `
-Body '{"screen_name":"MyScreenName", "password":"thenewpassword"}' `
-Method Put `
-ContentType "application/json"

Этот запрос отображает список сессий для всех авторизованных пользователей.

Invoke-WebRequest -Uri http://localhost:8080/session -Method Get

Invoke-WebRequest -Uri http://localhost:8080/chat/room/public `
-Body '{"name":"Office Hijinks"}' `
-Method Post `
-ContentType "application/json"

Invoke-WebRequest -Uri http://localhost:8080/chat/room/public -Method Get

curl http://localhost:8080/user

AIM

curl -d'{"screen_name":"MyScreenName", "password":"thepassword"}' http://localhost:8080/user

ICQ

curl -d'{"screen_name":"100003", "password":"thepassw"}' http://localhost:8080/user

curl -X DELETE -d '{"screen_name": "user123"}' http://localhost:8080/user

curl -X PUT -d'{"screen_name":"MyScreenName", "password":"thenewpassword"}' http://localhost:8080/user/password

Этот запрос отображает список сессий для всех авторизованных пользователей.

curl http://localhost:8080/session

curl -d'{"name":"Office Hijinks"}' http://localhost:8080/chat/room/public

curl http://localhost:8080/chat/room/public