You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: Refactor deployment guide in README to link external documentation, introduce a one-click Docker installation script, and add smart replace test cases documentation.
In the main local service, configure one or more Agent Computer deployment addresses to use the Agent Computer (Sandbox). Since the "Agent Computer (Sandbox)" includes a personal computer (sandbox) which requires more resources, it supports separate deployment across multiple servers.
46
45
47
-
The following commands require Docker permissions or can be run with sudo
# Extract downloaded client files to working directory
65
-
tar -xzf nuwax-cli-*.tar.gz
66
-
67
-
# Add execute permission
68
-
chmod +x nuwax-cli
69
-
70
-
# Initialize
71
-
./nuwax-cli init
72
-
73
-
# Start deployment, if you need to specify project name or access port (default 80), you can use the following command:
74
-
# ./nuwax-cli auto-upgrade-deploy run --port 8099 -p nuwax
75
-
./nuwax-cli auto-upgrade-deploy run
76
-
```
77
-
78
-
> **Important Note**: It is recommended to regularly upgrade the command line tool by executing in the working directory:
79
-
>
80
-
> ```bash
81
-
> ./nuwax-cli check-update install
82
-
>```
83
-
84
-
Normally, after executing the commands, the service should be deployed successfully.
85
-
86
-
##### Access Service
87
-
88
-
After deployment is complete, access in browser: `http://localhost`
89
-
90
-
Login with default administrator account: `admin@nuwax.com` password: `123456`
91
-
92
-
> Note: If port 80 is occupied, you can specify a port for deployment, such as: `./nuwax-cli auto-upgrade-deploy run --port 8099`
93
-
94
-
##### Important Configuration
95
-
96
-
Please modify promptly after login:
97
-
98
-
- Administrator password
99
-
- Site information configuration
100
-
- Email service configuration for user registration and login verification codes.
101
-
102
-
### Troubleshooting
103
-
104
-
#### 1. Service Startup Failed
105
-
106
-
- Check if Docker is running properly
107
-
- Use `./nuwax-cli status` to view detailed status
108
-
- Check if ports are occupied
109
-
110
-
#### 2. Unable to Access Service
111
-
112
-
- Confirm service has started properly, you can execute `docker ps` or `./nuwax-cli ducker` to view container status
113
-
- Check firewall settings
114
-
- Confirm port configuration is correct
50
+
#### Agent Computer (Sandbox) Deployment Guide
115
51
116
-
#### 3. Permission Issues - Permission denied
52
+
You can deploy Agent Computer services on multiple different servers, achieving distributed agent sandbox capabilities through configuration.
117
53
118
-
- **Linux (Ubuntu 22.04 LTS)**: Ensure user is in docker group
119
-
- **macOS**: Allow unknown developers to run, ensure OrbStack or Docker Desktop is started
54
+
> **Environment Requirements**: Each server needs Docker and Docker Compose environment installed, refer to [Docker Installation Documentation](https://nuwax.com/deploy.html#%E6%8E%A8%E8%8D%90%E6%96%B9%E6%A1%88-%E4%B8%80%E9%94%AE%E5%AE%89%E8%A3%85%E9%85%8D%E7%BD%AE-docker-%E8%84%9A%E6%9C%AC).
120
55
121
-
Use `sudo` to execute commands: `sudo ./nuwax-cli auto-upgrade-deploy run`
122
-
123
-
#### 4. Extraction Failed - Directory not empty(os error 39)
124
-
125
-
First stop Docker service: `./nuwax-cli docker-service stop`, then manually delete the `docker` directory in the working directory and re-execute the deployment command.
126
-
127
-
#### 5. Interface Shows System Exception
128
-
129
-
Check backend logs: `./docker/logs/agent/app.log`, usually restarting the service can resolve:
130
-
131
-
```bash
132
-
./nuwax-cli docker-service restart
133
-
```
134
-
135
-
#### 6. Download Failed - error decoding response body
136
-
137
-
Network issues cause this, re-executing the deployment command will work, supports resumable downloads.
This script supports 13 Linux distributions, including domestic operating systems (openEuler, Anolis OS, OpenCloudOS, Alinux, Kylin Linux), one-click installation of docker, docker-compose with automatic configuration of Xuanyuan mirror acceleration.
✅ Complete support for domestic operating systems: Deep adaptation for domestic OS (openEuler, Anolis OS, OpenCloudOS, Alinux, Kylin Linux), supports automatic version detection and optimal configuration
116
+
117
+
✅ Intelligent multi-mirror source switching: Built-in 6+ domestic mirror sources including Alibaba Cloud, Tencent Cloud, Huawei Cloud, USTC, Tsinghua, etc., automatically detects and selects the fastest source
118
+
119
+
✅ Special handling for older systems: Supports expired systems like Ubuntu 16.04, Debian 9/10, automatically configures compatible installation solutions
120
+
121
+
✅ Dual installation guarantee: Automatically switches to binary installation if package manager installation fails, ensuring installation success rate
122
+
123
+
✅ macOS/Windows friendly prompts: Automatically detects macOS and Windows systems, provides appropriate Docker Desktop installation guidance
0 commit comments