Skip to content

Latest commit

 

History

History
79 lines (48 loc) · 3.74 KB

README.md

File metadata and controls

79 lines (48 loc) · 3.74 KB

Web-IDE

cover

Docker GitHub license

What is it?

Web-IDE is a comprehensive web-based integrated development environment (IDE) that includes all the tools you need for an enjoyable coding experience, out-of-the-box.

Features

  • Start the IDE with a single command line, powered by Docker and code-server.
  • Access IDE through your browser and code from any machine, anywhere.
  • A wealth of pre-installed development tools for an out-of-the-box coding experience:
    • Node (Frontend)
    • Go
    • Python
    • Java

Usage

docker run -itd -p 8080:8080 -e PASSWORD=your_password --name web-ide zengmingjian/web-ide

After running the command, open http://127.0.0.1:8080 in your browser, enter your password and start coding!

Note: 中国用户因为 Docker Hub 被墙，如果不能拉取镜像，可以从 Github Releases 页面下载镜像文件，然后使用 docker load -i xxx.tgz 命令加载镜像。如果 Github Releases 页面下载也很慢，推荐：https://ghp.ci。

Advanced Usage

  • Add more CLI options for web-ide at the end of the command.

    docker run -itd --net host -e PASSWORD=your_password --name web-ide zengmingjian/web-ide --bind-addr 0.0.0.0:9090

  • Run docker run -it --rm zengmingjian/web-ide --help for more information.

  • To check the environment configuration, run cat ~/.zshrc inside a container. Feel free to edit it.

FAQ

Q: Some shortcuts conflict between web-vscode and the browser. How can I avoid this?

A: Convert this web vscode into a Progressive Web App (PWA).

Q: Some extensions, which use iframes to render their UI, don't work properly, like git graph. How can I solve this problem?

A: This issue occurs when you access vscode in the browser with a website address that is not localhost and a protocol that is not https. Here are some solutions:

  • Set up a forward proxy with the command ssh -CqTnNfL 8080:127.0.0.1:8080 my-remote-server. Then access vscode via http://localhost:8080.
  • Open chrome://flags/#unsafely-treat-insecure-origin-as-secure in your browser to trust insecure origins. Then access vscode via http://some-ip-or-domain:8080.
  • Use an https protocol instead of http.

Q: This Docker container is unable to log in to another remote server via SSH. What could be the cause, and how can it be resolved?

A: Probably, the remote server does not support the rsa algorithm due to security concerns. Here are two alternatives:

  • Generate your SSH key using the ed25519 algorithm, with ssh-keygen -t ed25519.
  • Add HostkeyAlgorithms +ssh-rsa\n PubkeyAcceptedAlgorithms +ssh-rsa\n PubkeyAcceptedKeyTypes +ssh-rsa to ~/.ssh/config. For example: Hostname [email protected]\n HostkeyAlgorithms +ssh-rsa\n PubkeyAcceptedAlgorithms +ssh-rsa\n PubkeyAcceptedKeyTypes +ssh-rsa\n

Q: Running pnpm install failed with ENOENT: no such file or directory.

A: If you are using macOS, mounting volume in virtiofs mount type will be unstable to use pnpm. Here are 3 workarounds:

  • Set the container file sharing to gRPC FUSE implementation. Refer this comment.
  • Add package-import-method=clone-or-copy to the ~/.npmrc file.
  • Add store-dir=${HOME}/.local/share/pnpm/store to the ~/.npmrc file.

Show your support

Give a ⭐️ if this project helped you!

License

MIT