2020-02-02 05:20:10 +00:00
|
|
|
# docker-ubuntu-vnc
|
|
|
|
|
2020-02-02 13:54:07 +00:00
|
|
|
[![Docker Cloud Build Status](https://img.shields.io/docker/cloud/build/dcsunset/ubuntu-vnc)](https://hub.docker.com/r/dcsunset/ubuntu-vnc)
|
|
|
|
[![Docker Image Size](https://badgen.net/docker/size/dcsunset/ubuntu-vnc)](https://hub.docker.com/r/dcsunset/ubuntu-vnc)
|
|
|
|
|
|
|
|
A docker image of Ubuntu with Xfce desktop and VNC support.
|
2020-02-02 05:20:10 +00:00
|
|
|
|
2020-02-04 02:39:37 +00:00
|
|
|
## Screenshots
|
|
|
|
|
|
|
|
![Figure 1](./screenshots/1.png)
|
|
|
|
|
|
|
|
![Figure 2](./screenshots/2.png)
|
|
|
|
|
2020-02-03 07:33:11 +00:00
|
|
|
## Tags
|
|
|
|
|
|
|
|
Different tags of this image are based on different versions of ubuntu.
|
|
|
|
|
|
|
|
Currently available tags:
|
|
|
|
|
|
|
|
* latest: based on ubuntu:lastest
|
|
|
|
* 18.04: based on ubuntu:18.04
|
|
|
|
* 16.04: based on ubuntu:16.04
|
|
|
|
|
2020-02-05 08:06:38 +00:00
|
|
|
## Pull image
|
|
|
|
|
|
|
|
```
|
|
|
|
docker pull dcsunset/ubuntu-vnc:<tag>
|
|
|
|
```
|
|
|
|
|
|
|
|
The tag can be one of those listed above.
|
|
|
|
|
2020-02-02 05:20:10 +00:00
|
|
|
## Usage
|
|
|
|
|
2020-02-02 12:03:49 +00:00
|
|
|
Simple usage:
|
|
|
|
|
2020-02-02 05:20:10 +00:00
|
|
|
```
|
2020-02-02 12:03:49 +00:00
|
|
|
docker run -d -p 5900:5900 -p 6080:6080 -e VNC_PASSWD=password dcsunset/ubuntu-vnc
|
2020-02-02 05:20:10 +00:00
|
|
|
```
|
|
|
|
|
2020-02-05 08:06:38 +00:00
|
|
|
Then visit <http://localhost:6080> to visit noVNC UI.
|
2020-02-02 12:03:49 +00:00
|
|
|
Or you can use a different VNC client (like TigerVNC client)
|
|
|
|
and connect to localhost:5900.
|
|
|
|
|
2020-02-02 05:20:10 +00:00
|
|
|
If `VNC_PASSWD` is not set,
|
|
|
|
then the security type of vncserver is set to None,
|
|
|
|
it is **insecure** when exposing the container on the Internet.
|
|
|
|
|
|
|
|
## Exposed ports
|
|
|
|
|
|
|
|
* 5900: Used for VNC interface
|
2020-02-02 11:58:03 +00:00
|
|
|
* 6080: Used for noVNC Web UI
|
2020-02-02 05:20:10 +00:00
|
|
|
|
|
|
|
## Installed applications
|
|
|
|
|
|
|
|
To make the image lightweight,
|
|
|
|
only the following applications are installed by default:
|
|
|
|
|
|
|
|
* Xfce desktop
|
|
|
|
* TigerVNC server
|
2020-02-02 12:03:49 +00:00
|
|
|
* noVNC
|
2020-02-02 13:54:07 +00:00
|
|
|
* wget
|
2020-02-03 07:33:11 +00:00
|
|
|
* Python3
|
2020-02-02 05:20:10 +00:00
|
|
|
* Vim
|
|
|
|
* Chromium browser
|
|
|
|
|
2020-02-02 11:58:03 +00:00
|
|
|
## Build
|
2020-02-02 05:20:10 +00:00
|
|
|
|
2020-02-02 11:58:03 +00:00
|
|
|
To use the latest Ubuntu image:
|
2020-02-02 05:20:10 +00:00
|
|
|
|
|
|
|
```
|
2020-02-02 11:58:03 +00:00
|
|
|
docker build -t ubuntu-vnc .
|
2020-02-02 05:20:10 +00:00
|
|
|
```
|
|
|
|
|
2020-02-02 11:58:03 +00:00
|
|
|
Or specify a version:
|
2020-02-02 05:20:10 +00:00
|
|
|
|
|
|
|
```
|
2020-02-02 11:58:03 +00:00
|
|
|
docker build --build-arg VERSION=18.04 -t ubuntu-vnc .
|
2020-02-02 05:20:10 +00:00
|
|
|
```
|
|
|
|
|
2020-02-02 11:58:03 +00:00
|
|
|
## FAQ
|
|
|
|
|
|
|
|
### Fonts
|
|
|
|
|
|
|
|
If non-latin characters are not displayed well,
|
|
|
|
install the font packs based on your needs.
|
|
|
|
|
|
|
|
To install the Indian font pack:
|
2020-02-02 05:20:10 +00:00
|
|
|
|
|
|
|
```
|
2020-02-02 11:58:03 +00:00
|
|
|
apt-get install fonts-indic
|
2020-02-02 05:20:10 +00:00
|
|
|
```
|
|
|
|
|
2020-02-02 11:58:03 +00:00
|
|
|
To install the CJK font pack:
|
2020-02-02 05:20:10 +00:00
|
|
|
|
|
|
|
```
|
2020-02-02 11:58:03 +00:00
|
|
|
apt-get install fonts-noto-cjk
|
2020-02-02 05:20:10 +00:00
|
|
|
```
|
|
|
|
|
2020-02-02 11:58:03 +00:00
|
|
|
To install the international font pack:
|
2020-02-02 05:20:10 +00:00
|
|
|
|
|
|
|
```
|
2020-02-02 11:58:03 +00:00
|
|
|
apt-get install fonts-noto
|
2020-02-02 05:20:10 +00:00
|
|
|
```
|
2020-02-02 11:58:03 +00:00
|
|
|
|
|
|
|
### Scaling
|
|
|
|
|
|
|
|
By default, noVNC's scaling mode is set to None.
|
|
|
|
It can be changed in the noVNC panel easily.
|
2020-02-02 12:08:33 +00:00
|
|
|
|
|
|
|
|
2020-02-05 03:50:41 +00:00
|
|
|
## License
|
2020-02-02 12:08:33 +00:00
|
|
|
|
|
|
|
MIT License
|