ドキュメントのナビゲーションを表示

インストール

Windows と WinBox 8291 接続で準備できます。機器への追加インストールは不要です。

対象
Windows 10 と Windows 11、x64
最終更新

パソコン側に必要なもの#

項目必要なもの
オペレーティングシステムWindows 10 または Windows 11
アーキテクチャx64(ふつうの 64 ビット版 Windows)
先に入れておくもの不要です。必要なものはすべて中に同梱しています。
macOS / Linuxありません。macOS 版・Linux 版は提供していません。

動作に必要なものはすべてアプリの中に入っているので、 「先にこのフレームワークを入れる」という手順はありませんし、 マシン上のほかのソフトとバージョンがぶつかることもありません。

機器側に必要なもの#

RosRunner は RouterOS 機器に何もインストールしません。 機器がもともと備えている管理の口を使うので、重要なのは「どれが有効になっているか」だけです。

接続の種類機器側に必要なもの
WinBox と同じ接続 (8291)WinBox サービスが 8291 で届くこと。MAC アドレスで接続する場合(まだ使える IP がない機器など)は、そのインターフェイスでそれが許可されており、かつ同じネットワークにいること。

任意のプロトコル(必須ではありません)#

接続サービス
APIAPI サービスが届くこと。なお API でのコマンド実行は RouterOS 7.x のみ
SSH/ip service ssh が有効であること。
REST/ip service www または www-ssl が有効であること。RouterOS 6.x に REST はそもそもありません。

いずれも RouterOS 6.49.x7.21.x / 7.23.x で実機確認しています。

2 つの版#

アプリそのものは同じです。違うのはインストールの方法と、自分自身を更新できるかどうかだけです。

インストール版ポータブル版
インストール先ご自身のユーザープロファイル配下のフォルダーどこにも——実行ファイル 1 つ、どこからでも実行できます
更新新しいバージョンを自分でダウンロードして適用新しいバージョンがあることを知らせるだけでダウンロードページを開きます。差し替えは手動
向いている場面普段使っているパソコンUSB メモリ、制限の厳しいパソコン、インストールせずに試したいとき

どちらもすべてを同梱した単一の実行ファイルです。 どちらも実行に管理者権限は不要で、どちらもバックグラウンドに常駐するものを勝手に入れたりしません。

データの保存先#

保存した機器のまとまり、設定、コマンド履歴は、ご自身のユーザープロファイル配下の、 アプリ本体とは別の場所に置かれます。どちらの版でも同じ場所です。

この分離は意図的です。アプリを削除してもこれらは一緒に消えませんし、 ポータブル版とインストール版を行き来しても失われません。

保存した資格情報は、RosRunner が独自に考えたファイル形式ではなく、 Windows の資格情報マネージャー——OS がほかのパスワードをすでに保管しているあの場所——に入ります。 アプリが動いている間、入力したパスワードはメモリの中にあります。

更新のしくみ#

インストール版は新しいバージョンを確認し、自分でダウンロードして適用できます。 ポータブル版も確認しますが、ステータスバーで知らせてダウンロードページを開くだけで、 自分自身を置き換えることはしません。

知っておくとよいこと:

  • 更新は製品自身の更新アドレスからしか取得しません。

アプリの中に GitHub やクラウドストレージのアドレス・鍵は入っていません。

  • 更新に失敗しても、すでに使用中のバージョンには影響しません。

アプリが起動できなくなることもありません。

  • ダウンロード中にキャンセルすると、取得した分は破棄されます。一時停止も再開もありません——

できないことを約束するボタンを置かず、そのまま説明します。

  • 更新の適用時はアプリが再起動します。開いているウィンドウは強制終了ではなく、通常の終了処理を通ります。

初回起動#

使い始める前に設定しておくことはありません。初回は空の機器一覧が開き、 そこから先ははじめかたが案内します。

インターフェイスの言語を変えたい場合は、実行中に切り替えられます。再起動は要りません。 English、繁體中文、日本語を内蔵しており、ライトテーマとダークテーマもあります。