GNS3 server
您最多选择25个主题 主题必须以字母或数字开头,可以包含连字符 (-),并且长度不得超过35个字符
grossmj 6d66e4d5d5 Release v2.2.5 1周前
conf Merge branch 'master' into 2.2 1周前
docs Sync documentation 1周前
gns3server Release v2.2.5 1周前
init Make sure upstart LANG is utf8 2 年前
scripts Add `LimitNOFILE=16384` to GNS3 service. Ref #1678 2 个月前
tests Fix tests. 1周前
.coveragerc Fix coveralls configuration 4 年前
.gitattributes Keep the untouched when merging 3 年前
.gitignore Added workaround for #1690. Added venv/ to .gitignore 2 个月前
.pyup.yml Update pyup config to use 2.2 branch 2 年前
.travis.yml Python3.8 support. Ref 2 个月前
CHANGELOG Release v2.2.5 1周前 Merge branch 'master' into 1.5 3 年前
Dockerfile Update Dockerfile to Ubuntu 18.04 8 个月前
DockerfileTests.tpl Tests on TravisCI with docker compose 2 年前
LICENSE Project structure & tools (pytest, tox etc.) 6 年前 Remove 'include INSTALL' from MANIFEST. 1年前
README.rst Update README.rst 6 个月前
appveyor.yml Remove not working trigger of nightly build 2 年前
dev-requirements.txt Update pytest from 4.4.0 to 4.4.1 9 个月前
docker-compose.yml Tests on TravisCI with docker compose 2 年前
gns3server.bat Made the gns3server.bat successfully start the server independent of the CWD at the time of running. It's now relative to the location of the .bat file itself. 4 年前
pytest.ini pytest.ini for ignoring files and recording DEBUG level in tests 1年前
readthedocs.yml Use Python3.6 to build the API documentation. 1年前
requirements.txt Make sure still support Python >= 3.5.3 2 个月前 Python3.8 support. Ref 2 个月前
tox.ini Increase test timeout to avoid random problems on travis 3 年前
win-requirements.txt Early Hyper-V support to run the GNS3 VM. Ref 1年前



.. image::

.. image::

This is the GNS3 server repository.

The GNS3 server manages emulators such as Dynamips, VirtualBox or Qemu/KVM.
Clients like the GNS3 GUI controls the server using a HTTP REST API.

You will need the GNS3 GUI (gns3-gui repository) to control the server.


master is the next stable release, you can test it in your day to day activities.
Bug fixes or small improvements pull requests go here.

2.x (2.1 for example)
Next major release

*Never* use this branch for production. Pull requests for major new features go here.


GNS3 is perhaps packaged for your distribution:

* Gentoo:
* Alpine:

Linux (Debian based)

The following instructions have been tested with Ubuntu and Mint.
You must be connected to the Internet in order to install the dependencies.


- Python 3.4 or above
- aiohttp
- setuptools
- psutil
- jsonschema

The following commands will install some of these dependencies:

.. code:: bash

sudo apt-get install python3-setuptools

Finally these commands will install the server as well as the rest of the dependencies:

.. code:: bash

cd gns3-server-master
sudo python3 install

To run tests use:

.. code:: bash

py.test -v

Docker container

For development you can run the GNS3 server in a container

.. code:: bash

bash scripts/

Run as daemon (Unix only)

You will find init sample scripts for various systems
inside the init directory.

Usefull options:

* --daemon: start process as a daemon
* --log logfile: store output in a logfile
* --pid pidfile: store the pid of the running process in a file and prevent double execution

All init scripts require the creation of a GNS3 user. You can change it to another user.

.. code:: bash

sudo adduser gns3


For ubuntu < 15.04

You need to copy init/gns3.conf.upstart to /etc/init/gns3.conf

.. code:: bash

sudo chown root /etc/init/gns3.conf
sudo service gns3 start


You need to copy init/gns3.service.systemd to /lib/systemd/system/gns3.service

.. code:: bash

sudo chown root /lib/systemd/system/gns3.service
sudo systemctl start gns3


Please use our `all-in-one installer <>`_ to install the stable build.

If you install via source you need to first install:

- Python (3.3 or above) -
- Pywin32 -

Then you can call

.. code:: bash

python install

to install the remaining dependencies.

To run the tests, you also need to call

.. code:: bash

pip install pytest pytest-capturelog

before actually running the tests with

.. code:: bash

python test

or with

.. code:: bash

py.test -v

Mac OS X

Please use our DMG package for a simple installation.

If you want to test the current git version or contribute to the project,
you can follow these instructions with virtualenwrapper:
and homebrew:

.. code:: bash

brew install python3
mkvirtualenv gns3-server --python=/usr/local/bin/python3.5
python3 install


If you want enable SSL support on GNS3 you can generate a self signed certificate:

.. code:: bash

bash gns3server/cert_utils/

This command will put the files in ~/.config/GNS3/ssl

After you can start the server in SSL mode with:

.. code:: bash

python gns3server/ --certfile ~/.config/GNS3/ssl/server.cert --certkey ~/.config/GNS3/ssl/server.key --ssl

Or in your gns3_server.conf by adding in the Server section:

.. code:: ini


Running tests

Just run:

.. code:: bash

py.test -vv

If you want test coverage:

.. code:: bash

py.test --cov-report term-missing --cov=gns3server

Security issues
Please contact us using contact form available here: